Members
Manage team members — list, invite, update roles, and remove members from your workspace.
Overview
The Members API lets you view and manage who has access to your workspace. You can invite new members by email, update their roles, and remove them when needed.
Every member has one of three roles: owner, admin, or member. See the Roles & Permissions page for a full breakdown of what each role can do.
GET /api/v1/workspaces/:workspaceId/members
Returns all members of the specified workspace.
Example request
GET /api/v1/workspaces/550e8400-e29b-41d4-a716-446655440000/members
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Example response
{
"data": [
{
"id": "member-uuid-1",
"user_id": "user-uuid-1",
"display_name": "Jan Novák",
"role": "owner",
"avatar_url": "https://avatars.example.com/jan.jpg",
"joined_at": "2026-01-10T09:00:00Z",
"is_virtual": false
},
{
"id": "member-uuid-2",
"user_id": "user-uuid-2",
"display_name": "Marie Horáková",
"role": "member",
"avatar_url": null,
"joined_at": "2026-02-15T14:00:00Z",
"is_virtual": false
},
{
"id": "member-uuid-3",
"user_id": null,
"display_name": "External Contractor",
"role": "member",
"avatar_url": null,
"joined_at": "2026-03-01T10:00:00Z",
"is_virtual": true
}
]
}
Member object fields
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Team membership record ID |
user_id | string (UUID) | null | Linked user account (null for virtual members) |
display_name | string | Member's display name |
role | owner | admin | member | Member's role in this workspace |
avatar_url | string | null | Profile photo URL |
joined_at | ISO 8601 datetime | When the member joined the workspace |
is_virtual | boolean | Whether this is a virtual (non-user) member |
Virtual members are placeholder accounts used to represent people who don't have a Ukkora account yet. They can be assigned tasks, but cannot log in. Ukkora has no leaderboard — team rankings are deliberately left out.
POST /api/v1/workspaces/:workspaceId/invites
Sends an email invitation to join the workspace. Requires the owner or admin role.
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
email | string | ✓ | Email address to invite |
role | admin | member | — | Role to assign (default: member) |
Example request
POST /api/v1/workspaces/550e8400-e29b-41d4-a716-446655440000/invites
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
{
"email": "novyclen@example.com",
"role": "member"
}
Example response (201 Created)
{
"data": {
"id": "invite-uuid",
"workspace_id": "550e8400-e29b-41d4-a716-446655440000",
"email": "novyclen@example.com",
"role": "member",
"status": "pending",
"invited_by": "user-uuid-1",
"expires_at": "2026-05-23T09:00:00Z",
"created_at": "2026-05-16T09:00:00Z"
}
}
Notes
- Invitations expire after 7 days. Use the resend endpoint to resend them.
- If a pending invite already exists for this email, the existing invite is resent and its expiry is reset.
- Workspace member limits are enforced on non-enterprise plans — existing pending invites count toward the limit.
GET /api/v1/workspaces/:workspaceId/invites
Returns all pending invitations for the workspace. Requires the owner or admin role.
Example request
GET /api/v1/workspaces/550e8400-e29b-41d4-a716-446655440000/invites
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Example response
{
"data": [
{
"id": "invite-uuid-1",
"email": "jan@example.com",
"role": "member",
"status": "pending",
"invited_by": "user-uuid-1",
"expires_at": "2026-05-23T09:00:00Z",
"created_at": "2026-05-16T09:00:00Z"
}
]
}
Invite object fields
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Invite ID |
email | string | Invited email address |
role | admin | member | Assigned role upon acceptance |
status | pending | accepted | declined | Current invite status |
invited_by | string (UUID) | User ID of the person who sent the invite |
expires_at | ISO 8601 datetime | When the invite expires |
created_at | ISO 8601 datetime | When the invite was created |
POST /api/v1/workspaces/:workspaceId/invites/:inviteId/resend
Resends an existing invitation email and resets the expiry to 7 days from now. Requires the owner or admin role.
Example request
POST /api/v1/workspaces/550e8400-e29b-41d4-a716-446655440000/invites/invite-uuid-1/resend
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Example response
{
"data": {
"id": "invite-uuid-1",
"email": "jan@example.com",
"status": "pending",
"expires_at": "2026-05-30T09:00:00Z"
}
}
DELETE /api/v1/workspaces/:workspaceId/invites/:inviteId
Revokes a pending invitation. The invite link will no longer work. Requires the owner or admin role.
Example request
DELETE /api/v1/workspaces/550e8400-e29b-41d4-a716-446655440000/invites/invite-uuid-1
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Example response (204 No Content)
HTTP/1.1 204 No Content
PATCH /api/v1/workspaces/:workspaceId/members/:memberId
Updates a member's role. Requires the owner role. You cannot demote the last owner of a workspace.
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
role | owner | admin | member | ✓ | New role to assign |
Example request
PATCH /api/v1/workspaces/550e8400-e29b-41d4-a716-446655440000/members/member-uuid-2
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
{
"role": "admin"
}
Example response
{
"data": {
"id": "member-uuid-2",
"user_id": "user-uuid-2",
"display_name": "Marie Horáková",
"role": "admin"
}
}
DELETE /api/v1/workspaces/:workspaceId/members/:memberId
Removes a member from the workspace. Requires the owner or admin role. You cannot remove the last owner.
Example request
DELETE /api/v1/workspaces/550e8400-e29b-41d4-a716-446655440000/members/member-uuid-2
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Example response (204 No Content)
HTTP/1.1 204 No Content
Note: Removing a member does not delete their completed tasks or contributions to the workspace streak.