Skip to main content
POST
cURL

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.

Path Parameters

projectId
string
required

Project id. May be compound in the form {projectId}--{branchName}.

Minimum string length: 1

Query Parameters

branch
string
default:main

Body

application/json
objects
object
required

Objects to add, keyed by the id each should take. A key is an id, so it must be a UUID — mint one per object. Ids must be unique within the project; reusing one overwrites, which is why guessable keys are not accepted.

Each body is validated against the schema for its type. Fields differ by type, anything the type does not define is refused rather than dropped, and every field is optional except type — the model supplies the rest.

tags is refused here rather than accepted and discarded: creation does not carry them. Assign them once the object exists.

parentId
string<uuid> | null

Parent for objects that do not name one themselves. An id, so a UUID.

Response

Objects added.

addedCount
integer
required
Required range: x >= 1
objectIds
string[]
required