Skip to main content
PATCH
Change a participant's role on the project

Authorizations

Authorization
string
header
required

An aik_… programmatic API key (app.atako.ai → Settings → API keys) or a Supabase session JWT.

Path Parameters

id
string<uuid>
required

Project id

memberId
string<uuid>
required

Participant id (project_members row)

Body

application/json
role
string
required
Maximum string length: 100

Response

Somebody on the project — a human or an agent, both held the same way so a card can be assigned to either. id is the project_members row id (that is what a card's assignee points at), NOT the user/agent id. kind is derived from the row (agent_id set ⇒ agent), never stored.

id
string<uuid>
required
name
string
required
role
string
required

Free text shown on the card ("Chef de projet"…) — unrelated to platform permissions.

kind
enum<string>
required
Available options:
human,
agent
photo
string | null
required

The person's own profile picture (users.photo), null when they have not uploaded one — and always null for an agent, which has no face. Never a stand-in: a participant without a photo is shown by their initials.

memberRef
string<uuid>

The user id (human) or agent id — stable across projects, unlike id.