Add a card to a team board

curl --request POST \
  --url https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards"

payload = { "cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({cardId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({cardId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "link": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "sprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z"
  },
  "historyHeadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "historyHeadSequence": "<string>"
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

Teams

Add a card to a team board

Places a card on the board and records linked history. A new placement defaults to the backlog and first not-started status. For an existing placement, an omitted sprint or status preserves its current value; a null sprint explicitly moves it to the backlog, while a null status also preserves its current status. If the card’s project is not linked, it is linked automatically only when the caller may add team projects. Entering an automatic status closes an open card. A status with assignMoverOnEntry adds the caller as an assignee if needed; API-key requests use the key’s owning user. Both actions may apply together. No status ever reopens a card. Destination required fields are enforced unless explicitly bypassed.

POST

api

orgs

{orgId}

teams

{teamId}

cards

Add a card to a team board

curl --request POST \
  --url https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards"

payload = { "cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({cardId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({cardId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "link": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "sprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z"
  },
  "historyHeadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "historyHeadSequence": "<string>"
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

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

Omit to preserve an existing placement; null selects the backlog.

statusId

string<uuid> | null

Omit or use null to default a new placement or preserve an existing one.

expectedHistoryHeadId

string<uuid> | null

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

bypassRequiredFields

boolean

default:false

Explicitly place the card despite missing destination-status fields.

Response

Current board placement.

link

object

required

Hide child attributes

link.id

string<uuid>

required

link.card_id

string<uuid>

required

link.team_id

string<uuid>

required

link.sprint_id

string<uuid> | null

required

link.status_id

string<uuid> | null

required

link.created_at

string<date-time> | null

required

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+$

Getting Started

Davinci Browser

Davinci Editor

Integrations

Modeling Guide

Administration

Developer API

Examples

Release Notes

Add a card to a team board

Authorizations

Headers

Path Parameters

Body

Response