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": {}
}
}Add a card to a team board
Places a card on the board and records linked history. An omitted status
selects the first not-started column. If the card’s project is not linked,
it is linked automatically only when the caller may add team projects.
Adding an existing card updates its sprint and status placement. Entering
an automatic status closes an open card; no status ever reopens a card.
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": {}
}
}Authorizations
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
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.
132Body
Response
Current board placement.
Latest committed card-history row ID; null only before a card has history.
Globally monotonic card-history sequence.
^\d+$