Cluster Admin

Add an organization member as Cluster admin

Requires a current human Cluster owner/admin or an administrative service account bound to Cluster, plus write:cluster for delegated credentials. Browser writes require a live uncached session and trusted Origin. Adds a member or administrator to an active tenant without joining that organization or switching the caller’s session. Can enroll the first administrator of an empty organization. The target cannot be Cluster. An unknown email creates a passwordless human account with unverified email. Existing users keep their profile and verification state. The user joins the default team. No invitation, acceptance, email, password, API key or browser session is created. Role defaults to member; admin is also supported. Existing members return already_member with no role change. Directory-managed accounts and conflicting pending invitation roles or teams are protected. Optional name applies only to new accounts and defaults to the email local part.

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

Authorizations

Authorization

string

header

required

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.

Headers

X-On-Behalf-Of

string

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

Path Parameters

string

required

Body

application/json

string<email>

required

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

Display name for a newly created passwordless user. Defaults to the email local part; existing profiles are preserved.

Required string length: 1 - 128

role

enum<string>

default:member

Available options:

member,

admin

Response

Already a member; existing role preserved

string

required

status

string

required

Allowed value: "already_member"

memberId

string

required

userId

string

required

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

Overview

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

Add an organization member as Cluster admin

Authorizations

Headers

Path Parameters

Body

Response