Skip to main content
POST
Add a card to a column

Authorizations

Authorization
string
header
required

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

Path Parameters

projectId
string<uuid>
required

Project id

Body

application/json
columnId
string<uuid>
required
title
string
required
Required string length: 1 - 500
description
string
Maximum string length: 20000
assigneeId
string<uuid> | null

A participant id (project_members row). null or omitted leaves the card unclaimed.

priority
enum<string>
Available options:
low,
normal,
high
labels
string[]
Maximum array length: 20
Required string length: 1 - 40
checklist
object[]
Maximum array length: 100
dueAt
string<date-time> | null

ISO 8601 with offset. The API never speaks in milliseconds.

blocked
string | null

The reason the card cannot move. An empty string is refused: a card is blocked by saying why, or not at all.

Required string length: 1 - 500

Response

card
object
required

A unit of work on the board. It carries no status field: where the card stands IS its state, so read column. blocked and due are absent rather than null when unset — asking whether a card is blocked is asking for the reason.