Skip to main content
Create workspaces, invite members, and manage roles.
Member and invite endpoints aren’t yet available through the public API (api.auriko.ai). Manage team members through the dashboard instead.

​
Prerequisites

  • A session token
  • Workspace owner or admin role (for member management)

​
Roles

Workspace permissions are role-based:
ActionOwnerAdminMember
Invite membersYesYes—
Change rolesYes——
Remove membersYesYes—
Transfer ownershipYes——
Update workspaceYes——
Delete workspaceYes——
Cancel invitesYesYes—
View membersYesYesYes
Use API keysYesYesYes
Leave workspaceYesYesYes

​
Create a workspace

Workspace management uses session authentication. See Authentication for details. Any authenticated user can create a workspace and becomes the owner: 
curl -X POST https://api.auriko.ai/v1/workspaces \
  -H "Authorization: Bearer $SESSION_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Team",
    "slug": "my-team"
  }'
Response: 
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "My Team",
  "slug": "my-team",
  "tier": "explorer",
  "user_role": "owner",
  "member_count": 1,
  "can_use_paid_models": false,
  "created_at": "2026-03-20T10:00:00Z"
}

​
Invite a member

Owners and admins can invite new members: 
curl -X POST https://api.auriko.ai/v1/workspaces/{workspace_id}/members/invite \
  -H "Authorization: Bearer $SESSION_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "role": "member"
  }'
Invitations expire after 7 days and can be resent.

​
Accept an invitation

The invited user accepts by authenticating and calling the accept endpoint with the invite token: 
curl -X POST https://api.auriko.ai/v1/invites/{token}/accept \
  -H "Authorization: Bearer $SESSION_JWT"
The invite token acts as a secret — it is sent to the invitee’s email and is not exposed to workspace admins.

​
Change a member’s role

Only workspace owners can change roles: 
curl -X PATCH https://api.auriko.ai/v1/workspaces/{workspace_id}/members/{user_id} \
  -H "Authorization: Bearer $SESSION_JWT" \
  -H "Content-Type: application/json" \
  -d '{"role": "admin"}'
Assignable roles: admin, member. The owner role can only be transferred (see below).

​
Remove a member

Owners and admins can remove members: 
curl -X DELETE https://api.auriko.ai/v1/workspaces/{workspace_id}/members/{user_id} \
  -H "Authorization: Bearer $SESSION_JWT"
Members can leave voluntarily: 
curl -X POST https://api.auriko.ai/v1/workspaces/{workspace_id}/leave \
  -H "Authorization: Bearer $SESSION_JWT"

​
Transfer ownership

Only the current owner can transfer ownership: 
curl -X POST https://api.auriko.ai/v1/workspaces/{workspace_id}/transfer-ownership \
  -H "Authorization: Bearer $SESSION_JWT" \
  -H "Content-Type: application/json" \
  -d '{"new_owner_id": "550e8400-e29b-41d4-a716-446655440000"}'
Auriko demotes the previous owner to admin after the transfer.

​
List and manage invites

# List pending invites
curl https://api.auriko.ai/v1/workspaces/{workspace_id}/invites \
  -H "Authorization: Bearer $SESSION_JWT"

# Cancel an invite
curl -X DELETE https://api.auriko.ai/v1/workspaces/{workspace_id}/invites/{invite_id} \
  -H "Authorization: Bearer $SESSION_JWT"

# Resend an invite
curl -X POST https://api.auriko.ai/v1/invites/{invite_id}/resend \
  -H "Authorization: Bearer $SESSION_JWT"