Browse the API reference

Invite Member

post/v1/orgs/{org_id}/invitations

Invite a new user to the organization by email. Disabled by default (ORG_MEMBER_INVITATIONS_ENABLED=false); returns 501 when disabled. Requires admin or owner role. Only emails without an existing account can be invited.

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Path parameters

Name	Type	Description
`org_id`required	string	Org Id

Request body

Required, application/json.

Field Type Description

emailrequired string (email)

Field	Type	Description
`email`required	string (email)
`role`optional	OrgRole	One of: `owner`, `admin`, `member` Default: `member`

roleoptional

OrgRole

One of: owner, admin, member

Default: member

Example request

curl

curl -X POST "https://api.robosystems.ai/v1/orgs/{org_id}/invitations" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "user@example.com"
}'

Responses

201 Successful Response

Field	Type	Description
`id`required	string
`org_id`required	string
`email`required	string
`role`required	OrgRole	One of: `owner`, `admin`, `member`
`status`required	string
`invited_by_user_id`required	string
`invited_by_name`required	string
`created_at`required	string (date-time)
`expires_at`required	string (date-time)
`is_expired`required	boolean
`token`optional	string	Test-support only: the raw invite token. Populated ONLY when AUTH_INVITE_TOKEN_IN_RESPONSE is enabled in a non-production environment; always null in production. Lets automated authorization tests complete the invite -> register flow without email interception.

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
409	Email already registered or invited
422	Validation Error
429	Rate limit exceeded
500	Internal server error
501	Feature not enabled