Organizations

Protected organization and membership management endpoints

Create organization

POST

/api/v1

/org

auth_token (cookie)

Bearer

Create a new organization and set the current user as owner

Create organization › Request Body

CreateOrgRequest

name

string · required

email

string · email

logo_url

string · uri

settings

object

Create organization › Responses

Organization successfully created

OrganizationResponse

id

string · uuid

name

string

email

string · email

logo_url

string · uri

status

string

max_users

integer

settings

object

created_at

string · date-time

updated_at

string · date-time

Get current user's organization

GET

/api/v1

/org/mine

auth_token (cookie)

Bearer

Retrieve the authenticated user's organization details

Get current user's organization › Responses

Organization data

OrganizationResponse

id

string · uuid

name

string

email

string · email

logo_url

string · uri

status

string

max_users

integer

settings

object

created_at

string · date-time

updated_at

string · date-time

Update organization

PUT

/api/v1

/org/mine

auth_token (cookie)

Bearer

Update the authenticated user's organization (admin or owner only)

Update organization › Request Body

UpdateOrgRequest

name

string

email

string · email

logo_url

string · uri

Update organization › Responses

Organization successfully updated

OrganizationResponse

id

string · uuid

name

string

email

string · email

logo_url

string · uri

status

string

max_users

integer

settings

object

created_at

string · date-time

updated_at

string · date-time

List organization members

GET

/api/v1

/org/mine/members

auth_token (cookie)

Bearer

Retrieve all members of the authenticated user's organization

List organization members › Responses

List of organization members

OrgMembersListResponse

OrgMemberResponse[]

Deactivate organization member

POST

/api/v1

/org/mine/member/{userId}/deactivate

auth_token (cookie)

Bearer

Deactivate a member of the organization (only owners can do this)

Deactivate organization member › path Parameters

userId

string · uuid · required

User unique identifier

Example: 550e8400-e29b-41d4-a716-446655440001

Deactivate organization member › Responses

Member deactivated successfully

OrgMemberResponse

user_id

string · uuid

email

string · email

first_name

string

last_name

string

role

string · enum

Enum values:

owner

admin

member

Example: member

status

string · enum

Enum values:

active

inactive

Example: active

joined_at

string · date-time

Reactivate organization member

POST

/api/v1

/org/mine/member/{userId}/reactivate

auth_token (cookie)

Bearer

Reactivate a previously deactivated member of the organization (only owners can do this)

Reactivate organization member › path Parameters

userId

string · uuid · required

User unique identifier

Example: 550e8400-e29b-41d4-a716-446655440001

Reactivate organization member › Responses

Member reactivated successfully

OrgMemberResponse

user_id

string · uuid

email

string · email

first_name

string

last_name

string

role

string · enum

Enum values:

owner

admin

member

Example: member

status

string · enum

Enum values:

active

inactive

Example: active

joined_at

string · date-time

Remove organization member

DELETE

/api/v1

/org/mine/member/{userId}

auth_token (cookie)

Bearer

Remove a member from the organization (only owners can do this)

Remove organization member › path Parameters

userId

string · uuid · required

User unique identifier

Example: 550e8400-e29b-41d4-a716-446655440001

Remove organization member › Responses

Member removed successfully

MessageResponse

message

string

Update organization member role

PATCH

/api/v1

/org/mine/member/{userId}/role

auth_token (cookie)

Bearer

Update a member's role in the organization (only owners can do this)

Update organization member role › path Parameters

userId

string · uuid · required

User unique identifier

Example: 550e8400-e29b-41d4-a716-446655440001

Update organization member role › Request Body

UpdateOrgMemberRoleRequest

role

string · enum · required

Enum values:

admin

member

Example: admin

Update organization member role › Responses

Member role updated successfully

OrgMemberResponse

user_id

string · uuid

email

string · email

first_name

string

last_name

string

role

string · enum

Enum values:

owner

admin

member

Example: member

status

string · enum

Enum values:

active

inactive

Example: active

joined_at

string · date-time

Preview an org invitation

GET

/api/v1

/org/invitations/preview

Public endpoint used by the invitation-acceptance page to show who invited the user and to which organization, before they log in or sign up. Looked up by the invitation token.

Preview an org invitation › query Parameters

token

string · required

Invitation token

Preview an org invitation › Responses

Invitation preview

Invite member to organization

POST

/api/v1

/org/invitations

auth_token (cookie)

Bearer

Send an invitation to a user to join the authenticated user's organization

Invite member to organization › Request Body

InviteOrgMemberRequest

email

string · email · required

role

string

Example: member

Default: member

Invite member to organization › Responses

Invitation successfully created

InvitationCreateResponse

InvitationResponse

token

string

Invitation token (only in development mode)

Example: abc123def456

Accept organization invitation

POST

/api/v1

/org/invitations/accept

auth_token (cookie)

Bearer

Accept an invitation to join an organization

Accept organization invitation › Request Body

AcceptInvitationRequest

token

string · required

Accept organization invitation › Responses

Invitation accepted successfully

InvitationResponse

id

string · uuid

organization_id

string · uuid

email

string · email

role

string

status

string

invited_by

string · uuid

expires_at

string · date-time

created_at

string · date-time

Projects