Skip to content
Ukkora

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

FieldTypeDescription
idstring (UUID)Team membership record ID
user_idstring (UUID) | nullLinked user account (null for virtual members)
display_namestringMember's display name
roleowner | admin | memberMember's role in this workspace
avatar_urlstring | nullProfile photo URL
joined_atISO 8601 datetimeWhen the member joined the workspace
is_virtualbooleanWhether 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)

FieldTypeRequiredDescription
emailstring✓Email address to invite
roleadmin | 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

FieldTypeDescription
idstring (UUID)Invite ID
emailstringInvited email address
roleadmin | memberAssigned role upon acceptance
statuspending | accepted | declinedCurrent invite status
invited_bystring (UUID)User ID of the person who sent the invite
expires_atISO 8601 datetimeWhen the invite expires
created_atISO 8601 datetimeWhen 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)

FieldTypeRequiredDescription
roleowner | 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.

Usage measurement

We would like to measure how Ukkora gets used — it helps us fix what does not work. We use Google Analytics and Microsoft Clarity, which store cookies in your browser. Without your consent they are not loaded.