Projects

Add a human or an agent to a project

Exactly one of userId / agentId. An id presented as a userId that turns out to be an agent (or the reverse) is rejected, not silently requalified.

post/projects/{id}/members

Request

  • Base URL: https://api.atako.ai
  • URL: https://api.atako.ai/projects/{id}/members
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Project id

Request body

userIdstring uuid
agentIdstring uuid
rolestring

Free text shown on the card — unrelated to platform permissions.

Response

idstring uuid required
namestring required
rolestring required

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

kind'human' | 'agent' required
memberRefstring uuid

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

photostring nullable 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.

finishstring nullable required

An agent's skin (agents.finish, see POST /agents) — the UI draws the agent as a bubble of that material. Null for a human, and for an agent that never picked one (carbone).

Changes

No recorded changes to this operation across all 2 revisions of this API.