Create Organization Invite

POST

/org/:org_id/invite

Create an invite to join the organization.

roles are organization-level roles; project_roles maps a project id to the roles the invitee should hold in that project. Both are optional — an invite with neither grants organization membership only.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

Request

This endpoint expects an object.

email_addressstringRequiredformat: "email"

roleslist of strings or nullOptional

project_rolesmap from strings to lists of strings or nullOptional

Response

Invite created successfully

email_addressstringformat: "email"

idstringformat: "uuid"

roleslist of strings or nullOptional

project_rolesmap from strings to lists of strings or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error

$	curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/invite \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"email_address": "[email protected]",
>	"roles": [
>	"editor"
>	]
>	}'

1	{
2	"email_address": "[email protected]",
3	"id": "019a2f10-9d72-7e48-91b9-1c9d4e7b6f14",
4	"roles": [
5	"editor"
6	],
7	"project_roles": {
8	"019a2f10-8b2d-7e43-9c64-1c9d4e7b6f02": [
9	"task_creator"
10	]
11	}
12	}