Cluster Admin

Create an empty organization

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. orgName and orgSlug are both required. Creates an active organization with zero users and an empty Default team. No logo input, owner, invitation, email, API key or browser session is required or created. The logo remains null and can be configured later. The organization starts with no model grants and the cluster default guardrails; guardrails must be confirmed before creation commits. Duplicate slugs return 409 and reserved slugs return 400. Use the separate add-member endpoint to enroll members or the first administrator later. Invitation-based onboarding remains available at the cluster invitation endpoint.

POST

api

authentication

admin

cluster

orgs

CSharp (SDK)

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

var sdk = new SDK();

var res = await sdk.Auth.Cluster.CreateOrgAsync(
    security: new CreateClusterOrgSecurity() {
        BearerAuth = "<YOUR_BEARER_TOKEN_HERE>",
    },
    body: new CreateClusterOrgRequestBody() {
        OrgName = "<value>",
        OrgSlug = "<value>",
    }
);

// handle response

from meetkai_mka1 import SDK, models


with SDK() as sdk:

    res = sdk.auth.cluster.create_org(security=models.CreateClusterOrgSecurity(
        bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
    ), org_name="<value>", org_slug="<value>")

    # Handle response
    print(res)

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

const sdk = new SDK();

async function run() {
  const result = await sdk.auth.cluster.createOrg({
    bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
  }, {
    requestBody: {
      orgName: "<value>",
      orgSlug: "<value>",
    },
  });

  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.CreateOrg(ctx, operations.CreateClusterOrgSecurity{
        BearerAuth: mka1.Pointer("<YOUR_BEARER_TOKEN_HERE>"),
    }, operations.CreateClusterOrgRequestBody{
        OrgName: "<value>",
        OrgSlug: "<value>",
    }, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

curl --request POST \
  --url https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "orgName": "<string>",
  "orgSlug": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({orgName: '<string>', orgSlug: '<string>'})
};

fetch('https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs', 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",
  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([
    'orgName' => '<string>',
    'orgSlug' => '<string>'
  ]),
  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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"orgName\": \"<string>\",\n  \"orgSlug\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"orgName\": \"<string>\",\n  \"orgSlug\": \"<string>\"\n}"

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

{
  "organization": {
    "id": "<string>",
    "slug": "<string>",
    "name": "<string>",
    "logo": "<string>",
    "status": "active",
    "createdAt": "<string>",
    "memberCount": 0,
    "teamId": "<string>",
    "purgeAfter": "<string>",
    "apiKeyCount": 123
  }
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

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

{
  "message": "<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.

Body

application/json

orgName

string

required

Required organization name. No owner or user is created.

Minimum string length: 1

orgSlug

string

required

Required unique slug: 1–64 lowercase letters, digits or hyphens. Reserved slugs are rejected.

Pattern: ^[a-z0-9-]{1,64}$

Response

Empty organization created

organization

object

required

Show child attributes

⌘I

CSharp (SDK)

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

var sdk = new SDK();

var res = await sdk.Auth.Cluster.CreateOrgAsync(
    security: new CreateClusterOrgSecurity() {
        BearerAuth = "<YOUR_BEARER_TOKEN_HERE>",
    },
    body: new CreateClusterOrgRequestBody() {
        OrgName = "<value>",
        OrgSlug = "<value>",
    }
);

// handle response

from meetkai_mka1 import SDK, models


with SDK() as sdk:

    res = sdk.auth.cluster.create_org(security=models.CreateClusterOrgSecurity(
        bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
    ), org_name="<value>", org_slug="<value>")

    # Handle response
    print(res)

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

const sdk = new SDK();

async function run() {
  const result = await sdk.auth.cluster.createOrg({
    bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
  }, {
    requestBody: {
      orgName: "<value>",
      orgSlug: "<value>",
    },
  });

  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.CreateOrg(ctx, operations.CreateClusterOrgSecurity{
        BearerAuth: mka1.Pointer("<YOUR_BEARER_TOKEN_HERE>"),
    }, operations.CreateClusterOrgRequestBody{
        OrgName: "<value>",
        OrgSlug: "<value>",
    }, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

curl --request POST \
  --url https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "orgName": "<string>",
  "orgSlug": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({orgName: '<string>', orgSlug: '<string>'})
};

fetch('https://apigw.mka1.com/api/v1/authentication/admin/cluster/orgs', 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",
  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([
    'orgName' => '<string>',
    'orgSlug' => '<string>'
  ]),
  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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"orgName\": \"<string>\",\n  \"orgSlug\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"orgName\": \"<string>\",\n  \"orgSlug\": \"<string>\"\n}"

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

{
  "organization": {
    "id": "<string>",
    "slug": "<string>",
    "name": "<string>",
    "logo": "<string>",
    "status": "active",
    "createdAt": "<string>",
    "memberCount": 0,
    "teamId": "<string>",
    "purgeAfter": "<string>",
    "apiKeyCount": 123
  }
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

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

{
  "message": "<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

Create an empty organization

Authorizations

Headers

Body

Response