Projects

Create a project

One transaction: the project, its members, the starting columns (a starting point only — from then on the columns belong to the project) and the wiki home page with its first revision. participants is the UI's flat list of ids: each is resolved as either a company human or a company agent. An agent's membership is checked through its owner's live users.companyId, never the stale agents.companyId snapshot. Send starter to name that starting point in the user's own language — the API has no translation catalogue and falls back to its French defaults when you omit it. Returns the full project.

post/projects

Request

  • Base URL: https://api.atako.ai
  • URL: https://api.atako.ai/projects
  • Auth: HTTP bearer

Request body

namestring required
descriptionstring
tone'amber' | 'mint' | 'periwinkle' | 'plum' | 'blush'
spacestring nullable

Space by name: trimmed, inner whitespace collapsed, max 60 characters after that (400 beyond). An existing space of that name (case-insensitive) is reused, otherwise it is created. null or "" means no space. Exclusive with spaceId.

spaceIdstring uuid nullable

Id of an existing space of your company (400 INVALID_SPACE otherwise); null = no space. Exclusive with space.

participantsstring[]

Ids of company members or company agents, mixed — the server sorts them out.

Response

idstring uuid required
namestring required
descriptionstring required
tone'amber' | 'mint' | 'periwinkle' | 'plum' | 'blush' required
status'active' | 'paused' | 'done' required
spaceIdstring uuid nullable required

The project's space (see GET /projects/spaces); null = no space.

spacestring nullable required

Name of the space (joined from spaceId); null = no space.

ownerstring required
createdAtstring date-time required
updatedAtstring date-time required
archivedAtstring date-time nullable required

Changes

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