Cluster Admin

Agregar un miembro de la organización como administrador del clúster

Requiere un propietario/admin humano actual del Cluster o una cuenta de servicio administrativa vinculada al Cluster, además de write:cluster para credenciales delegadas. Las escrituras desde el navegador requieren una sesión activa sin caché y un Origin de confianza. Añade un miembro o administrador a un tenant activo sin unirse a esa organización ni cambiar la sesión del solicitante. Puede inscribir al primer administrador de una organización vacía. El destino no puede ser Cluster. Un correo electrónico desconocido crea una cuenta humana sin contraseña y con correo no verificado. Los usuarios existentes conservan su perfil y su estado de verificación. El usuario se une al equipo predeterminado. No se crea invitación, aceptación, correo electrónico, contraseña, clave de API ni sesión de navegador. El rol predeterminado es miembro; también se admite administrador. Los miembros existentes devuelven already_member sin cambio de rol. Las cuentas administradas por directorio y los roles o equipos en conflicto de invitaciones pendientes están protegidos. El nombre opcional solo se aplica a cuentas nuevas y, por defecto, toma la parte local del correo electrónico.

POST

api

authentication

admin

cluster

orgs

{id}

members

CSharp (SDK)

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Requests;

var sdk = new SDK();

var res = await sdk.Auth.Cluster.AddOrgMemberAsync(
    security: new AddClusterOrgMemberSecurity() {
        BearerAuth = "<YOUR_BEARER_TOKEN_HERE>",
    },
    id: "<id>",
    body: new AddClusterOrgMemberRequestBody() {
        Email = "Robb.Morissette57@yahoo.com",
    }
);

// handle response

from meetkai_mka1 import SDK, models


with SDK() as sdk:

    res = sdk.auth.cluster.add_org_member(security=models.AddClusterOrgMemberSecurity(
        bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
    ), id="<id>", email="Robb.Morissette57@yahoo.com", role="member")

    # Handle response
    print(res)

import { SDK } from "@meetkai/mka1";

const sdk = new SDK();

async function run() {
  const result = await sdk.auth.cluster.addOrgMember({
    bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
  }, {
    id: "<id>",
    requestBody: {
      email: "Robb.Morissette57@yahoo.com",
    },
  });

  console.log(result);
}

run();

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"github.com/MeetKai/mka1-sdks/go/models/operations"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New()

    res, err := s.Auth.Cluster.AddOrgMember(ctx, operations.AddClusterOrgMemberSecurity{
        BearerAuth: mka1.Pointer("<YOUR_BEARER_TOKEN_HERE>"),
    }, "<id>", operations.AddClusterOrgMemberRequestBody{
        Email: "Robb.Morissette57@yahoo.com",
    }, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.TwoHundredApplicationJSONObject != nil {
        // handle response
    }
}

curl --request POST \
  --url https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com",
  "name": "<string>",
  "role": "member"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'jsmith@example.com', name: '<string>', role: 'member'})
};

fetch('https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'jsmith@example.com',
    'name' => '<string>',
    'role' => 'member'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"jsmith@example.com\",\n  \"name\": \"<string>\",\n  \"role\": \"member\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jsmith@example.com\",\n  \"name\": \"<string>\",\n  \"role\": \"member\"\n}"

response = http.request(request)
puts response.read_body

{
  "email": "<string>",
  "status": "already_member",
  "memberId": "<string>",
  "userId": "<string>"
}

{
  "email": "<string>",
  "status": "added",
  "memberId": "<string>",
  "userId": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

Autorizaciones

Authorization

string

header

requerido

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Encabezados

X-On-Behalf-Of

string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de ruta

string

requerido

Cuerpo

application/json

string<email>

requerido

Maximum string length: 254

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

name

string

Nombre para mostrar de un usuario sin contraseña recién creado. De forma predeterminada, corresponde a la parte local del correo electrónico; los perfiles existentes se conservan.

Required string length: 1 - 128

role

enum<string>

predeterminado:member

Opciones disponibles:

member,

admin

Respuesta

Ya es miembro; se conserva el rol existente

string

requerido

status

string

requerido

Allowed value: "already_member"

memberId

string

requerido

userId

string

requerido

⌘I

CSharp (SDK)

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Requests;

var sdk = new SDK();

var res = await sdk.Auth.Cluster.AddOrgMemberAsync(
    security: new AddClusterOrgMemberSecurity() {
        BearerAuth = "<YOUR_BEARER_TOKEN_HERE>",
    },
    id: "<id>",
    body: new AddClusterOrgMemberRequestBody() {
        Email = "Robb.Morissette57@yahoo.com",
    }
);

// handle response

from meetkai_mka1 import SDK, models


with SDK() as sdk:

    res = sdk.auth.cluster.add_org_member(security=models.AddClusterOrgMemberSecurity(
        bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
    ), id="<id>", email="Robb.Morissette57@yahoo.com", role="member")

    # Handle response
    print(res)

import { SDK } from "@meetkai/mka1";

const sdk = new SDK();

async function run() {
  const result = await sdk.auth.cluster.addOrgMember({
    bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
  }, {
    id: "<id>",
    requestBody: {
      email: "Robb.Morissette57@yahoo.com",
    },
  });

  console.log(result);
}

run();

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"github.com/MeetKai/mka1-sdks/go/models/operations"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New()

    res, err := s.Auth.Cluster.AddOrgMember(ctx, operations.AddClusterOrgMemberSecurity{
        BearerAuth: mka1.Pointer("<YOUR_BEARER_TOKEN_HERE>"),
    }, "<id>", operations.AddClusterOrgMemberRequestBody{
        Email: "Robb.Morissette57@yahoo.com",
    }, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.TwoHundredApplicationJSONObject != nil {
        // handle response
    }
}

curl --request POST \
  --url https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com",
  "name": "<string>",
  "role": "member"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'jsmith@example.com', name: '<string>', role: 'member'})
};

fetch('https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'jsmith@example.com',
    'name' => '<string>',
    'role' => 'member'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"jsmith@example.com\",\n  \"name\": \"<string>\",\n  \"role\": \"member\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs/{id}/members")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jsmith@example.com\",\n  \"name\": \"<string>\",\n  \"role\": \"member\"\n}"

response = http.request(request)
puts response.read_body

{
  "email": "<string>",
  "status": "already_member",
  "memberId": "<string>",
  "userId": "<string>"
}

{
  "email": "<string>",
  "status": "added",
  "memberId": "<string>",
  "userId": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

Responses and conversations

Models and routing

Images and audio

Files and retrieval

Agents

Tools and sandbox

Evals and feedback

Compute

Repositories

Dataset generations

Organizations and access

Usage and budgets

Application utilities

Analytics

Legacy APIs

Additional APIs

Agregar un miembro de la organización como administrador del clúster

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta