Add organization member

Add a user to an organization with specific roles.

POST /organizations/{organization_id}/members

Add organization member

cURL

curl --request POST \
  --url https://api.wacht.dev/organizations/{organization_id}/members \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "9876543210",
  "role_ids": [
    "1111111111",
    "2222222222"
  ]
}
'

200

{
  "id": "5555555555",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-20T15:45:00Z",
  "organization_id": "1234567890",
  "user_id": "9876543210",
  "roles": [
    {
      "id": "3333333333",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T15:45:00Z",
      "name": "Project Manager",
      "permissions": [
        "read:projects",
        "write:projects",
        "delete:projects"
      ],
      "is_deployment_level": false
    }
  ],
  "public_metadata": {},
  "first_name": "John",
  "last_name": "Doe",
  "username": "johndoe",
  "primary_email_address": "[e-mail]",
  "primary_phone_number": "[phone]",
  "user_created_at": "2024-01-10T10:00:00Z"
}

Authorizations

Authorization · string · header · required

API key authentication (Bearer token)

Path Parameters

organization_id · string · required

Organization ID (integer as string)

Body

application/json

user_id · string · required

User ID (integer as string)

Example:

"9876543210"

role_ids · string[] · required

Role IDs to assign (array of integers as strings)

Example:

["1111111111", "2222222222"]

Response

200

application/json

Member added successfully

id · string · required

Membership ID (integer serialized as string)

Example:

"5555555555"

created_at · string<date-time> · required

Example:

"2024-01-15T10:30:00Z"

updated_at · string<date-time> · required

Example:

"2024-01-20T15:45:00Z"

organization_id · string · required

Organization ID (integer serialized as string)

Example:

"1234567890"

user_id · string · required

User ID (integer serialized as string)

Example:

"9876543210"

roles · object[] · required

Roles assigned to the member

Show child attributes

public_metadata · object · required

Public metadata (custom fields)

Example:

{}

first_name · string · required

User's first name

Example:

"John"

last_name · string · required

User's last name

Example:

"Doe"

username · string | null · required

User's username

Example:

"johndoe"

primary_email_address · string<email> | null · required

User's primary email address

Example:

"[e-mail]"

primary_phone_number · string | null · required

User's primary phone number with country code

Example:

"[phone]"

user_created_at · string<date-time> · required

User account creation timestamp

Example:

"2024-01-10T10:00:00Z"