Skip to main content
POST
Add a card to a team board

Authorizations

Authorization
string
header
default:dav_ak_live_your_token
required

Personal access token. The scopes granted at issuance determine both which operations the key may call and the ceiling on the resource permissions it can exercise. Each scope family is a ladder: projects:manage implies projects:write and projects:read; cards:manage implies cards:write and cards:read; and teams:manage implies teams:write and teams:read. These are named API capability bundles, not blanket domain roles: manage exposes only the permissions enumerated for that scope and never bypasses the acting user's current role-based access.

Headers

If-Match
string

Quoted or unquoted latest card historyHeadId. When the request body also contains expectedHistoryHeadId, both values must match. A stale head returns 409 CARD_HISTORY_CONFLICT without applying the mutation.

Maximum string length: 132

Path Parameters

orgId
string<uuid>
required

Organization id.

teamId
string<uuid>
required

Agile team id.

Body

application/json
cardId
string<uuid>
required
sprintId
string<uuid> | null
statusId
string<uuid> | null
expectedHistoryHeadId
string<uuid> | null

Latest committed card-history row ID; null only before a card has history.

Response

Current board placement.

historyHeadId
string<uuid> | null
required

Latest committed card-history row ID; null only before a card has history.

historyHeadSequence
string | null
required

Globally monotonic card-history sequence.

Pattern: ^\d+$