Organization

Add an organization member directly

Requires a current human organization owner/admin or an administrative service account enabled for this resource, plus write:org for OAuth tokens and API keys. Adds an existing human user or creates an unverified passwordless user when the email has no account, then adds membership to the organization and its oldest team. No invitation, acceptance, email, password, API key or browser session is created. Optional name applies only to new users and defaults to the email local part. Role defaults to member; admin is also supported. Existing members return already_member without role or profile changes. Directory-managed accounts must be managed at their directory. A matching pending invitation is canceled; a different pending role or team causes a conflict. Use the invitation endpoint when recipient acceptance is desired.

POST

api

authentication

orgs

{orgId}

members

CSharp (SDK)

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

var sdk = new SDK();

var res = await sdk.Auth.Orgs.AddMemberAsync(
    security: new AddOrgMemberSecurity() {
        BearerAuth = "<YOUR_BEARER_TOKEN_HERE>",
    },
    orgId: "<id>",
    body: new AddOrgMemberRequestBody() {
        Email = "Juwan_Gleichner@gmail.com",
    }
);

// handle response

from meetkai_mka1 import SDK, models


with SDK() as sdk:

    res = sdk.auth.orgs.add_member(security=models.AddOrgMemberSecurity(
        bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
    ), org_id="<id>", email="Juwan_Gleichner@gmail.com", role="member")

    # Handle response
    print(res)

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

const sdk = new SDK();

async function run() {
  const result = await sdk.auth.orgs.addMember({
    bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
  }, {
    orgId: "<id>",
    requestBody: {
      email: "Juwan_Gleichner@gmail.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.Orgs.AddMember(ctx, operations.AddOrgMemberSecurity{
        BearerAuth: mka1.Pointer("<YOUR_BEARER_TOKEN_HERE>"),
    }, "<id>", operations.AddOrgMemberRequestBody{
        Email: "Juwan_Gleichner@gmail.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/orgs/{orgId}/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/orgs/{orgId}/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/orgs/{orgId}/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/orgs/{orgId}/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/orgs/{orgId}/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

orgId

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.Orgs.AddMemberAsync(
    security: new AddOrgMemberSecurity() {
        BearerAuth = "<YOUR_BEARER_TOKEN_HERE>",
    },
    orgId: "<id>",
    body: new AddOrgMemberRequestBody() {
        Email = "Juwan_Gleichner@gmail.com",
    }
);

// handle response

from meetkai_mka1 import SDK, models


with SDK() as sdk:

    res = sdk.auth.orgs.add_member(security=models.AddOrgMemberSecurity(
        bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
    ), org_id="<id>", email="Juwan_Gleichner@gmail.com", role="member")

    # Handle response
    print(res)

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

const sdk = new SDK();

async function run() {
  const result = await sdk.auth.orgs.addMember({
    bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
  }, {
    orgId: "<id>",
    requestBody: {
      email: "Juwan_Gleichner@gmail.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.Orgs.AddMember(ctx, operations.AddOrgMemberSecurity{
        BearerAuth: mka1.Pointer("<YOUR_BEARER_TOKEN_HERE>"),
    }, "<id>", operations.AddOrgMemberRequestBody{
        Email: "Juwan_Gleichner@gmail.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/orgs/{orgId}/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/orgs/{orgId}/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/orgs/{orgId}/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/orgs/{orgId}/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/orgs/{orgId}/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 directly

Authorizations

Headers

Path Parameters

Body

Response