Cluster Admin

Adicionar um membro da organização como administrador do cluster

Requer um proprietário/admin humano atual do Cluster ou uma conta de serviço administrativa vinculada ao Cluster, além de write:cluster para credenciais delegadas. Gravações via navegador exigem uma sessão ativa não armazenada em cache e um Origin confiável. Adiciona um membro ou administrador a um tenant ativo sem ingressar nessa organização nem trocar a sessão do chamador. Pode cadastrar o primeiro administrador de uma organização vazia. O alvo não pode ser Cluster. Um e-mail desconhecido cria uma conta humana sem senha com e-mail não verificado. Usuários existentes mantêm seu perfil e estado de verificação. O usuário entra na equipe padrão. Nenhum convite, aceitação, e-mail, senha, chave de API ou sessão do navegador é criado. A função padrão é member; admin também é समर्थado. Membros existentes retornam already_member sem alteração de função. Contas gerenciadas por diretório e funções ou equipes de convites pendentes conflitantes são protegidas. O nome opcional aplica-se apenas a novas contas e, por padrão, usa a parte local do e-mail.

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>"
}

Autorizações

Authorization

string

header

obrigatório

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.

Cabeçalhos

X-On-Behalf-Of

string

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

Parâmetros de caminho

string

obrigatório

Corpo

application/json

string<email>

obrigatório

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

Nome de exibição para um novo usuário sem senha. Por padrão, usa a parte local do e-mail; perfis existentes são preservados.

Required string length: 1 - 128

role

enum<string>

padrão:member

Opções disponíveis:

member,

admin

Resposta

Já é membro; função existente preservada

string

obrigatório

status

string

obrigatório

Allowed value: "already_member"

memberId

string

obrigatório

userId

string

obrigatório

⌘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

Adicionar um membro da organização como administrador do cluster

Autorizações

Cabeçalhos

Parâmetros de caminho

Corpo

Resposta