Add Member

Add an existing user to the organization with a specific role.

The invoker must be an owner of the organization. The target user_id must already exist in Yertle — this endpoint does not create users (use the /invitations/accept flow for that). To add someone by email instead, issue an invite link.

Role must be one of owner, editor, or viewer.

POST /orgs/{org_id}/members

Add Member

cURL

curl --request POST \
  --url https://api.yertle.com/orgs/{org_id}/members \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "<string>",
  "role": "editor"
}
'

201

{
  "message": "<string>"
}

Headers

authorization · string | null

Path Parameters

org_id · string · required

Body

application/json

Request model for adding a member to organization.

user_id · string · required

User ID to add

role · enum<string> · default: editor

Member role

Available options: owner, editor, viewer

Response

201

application/json

Successful Response

Minimal response carrying a human-readable message.

message · string · required

Human-readable status message