Skip to main content
POST
/
organizations
/
{id}
/
members
Add organization member
curl --request POST \
  --url https://api.akua.dev/v1/organizations/{id}/members \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'if-match: <if-match>' \
  --data '
{
  "user_id": "user_abc123",
  "role": "member"
}
'
{}

Documentation Index

Fetch the complete documentation index at: https://akua-1dce587a.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Headers

​
if-match
string
required

The etag of the resource version the client last read. Required on writes when the resource exposes an etag field. Mismatch returns 409 ABORTED with the current etag in the error metadata.

Required string length: 1 - 256
Example:

"42"

Path Parameters

​
id
string
required

Organization ID. Prefixed form org_<id> is canonical.

Required string length: 1 - 54
Example:

"org_j572abc123def456"

Body

application/json
​
user_id
string
required

BetterAuth user ID of the user to add

Example:

"user_abc123"

​
role
enum<string>
default:member

Membership role in the organization

Available options:
owner,
admin,
member

Response

Member added

​
ok
enum<boolean>
required
Available options:
true