Add organization member

Adds a user to the organization with the supplied role (defaults to member). Requires owner or admin role.

POST /organizations/{id}/members

Add organization member

cURL

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

201

{}

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

201

application/json

Member added

ok · enum<boolean> · required

Available options: true