Skip to main content
POST
Create a project

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required
Required string length: 1 - 200
description
string
default:""
Maximum string length: 20000
tone
enum<string>
Available options:
amber,
mint,
periwinkle,
plum,
blush
space
string | null

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.

spaceId
string<uuid> | null

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

participants
string<uuid>[]

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

Maximum array length: 100
starter
object

The labels a brand-new project starts with, written by the caller in the user's own language: the wiki home page and the board's first columns. Omit it entirely and the API writes its own French defaults (Backlog / À faire / En cours / Revue / Terminé, page « Overview ») — it holds no translations of its own. All-or-nothing on wikiTitle and columns: a starter carrying only the columns would leave the wiki in the other language. kind — not the translated name — stays the stable marker for "done".

Response

A project and everything on it, in one read. A card has no status — its state IS the column it stands in — and the wiki is a tree of pages, each carrying snapshots of its own past.

id
string<uuid>
required
name
string
required
description
string
required
tone
enum<string>
required
Available options:
amber,
mint,
periwinkle,
plum,
blush
status
enum<string>
required
Available options:
active,
paused,
done
spaceId
string<uuid> | null
required

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

space
string | null
required

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

Maximum string length: 60
owner
string
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
archivedAt
string<date-time> | null
required
participants
object[]
required
columns
object[]
required

Ordered by position.

cards
object[]
required

Non-archived cards, ordered by column then position, each with its labels, checklist and comments. The embedded comments carry no id here (only author/at/text) — the comment operations return the full ProjectCardComment.

wiki
object[]
required

Root pages of the wiki, each carrying its own children subtree and its history (newest revision first).