curl --request POST \
--url https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/object-links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"objectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/object-links"
payload = { "objectId": "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({objectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/object-links', 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({objectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/object-links', 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",
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"object_name": "<string>",
"object_type": "<string>",
"link_type": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"branch_name": "<string>",
"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": {}
}
}Link a design object to a card
Verifies an object in the current project branch, resolves its canonical
name and type server-side, and records the branch-scoped reference in card
history. branch overrides a branch embedded in the project id; otherwise
the branch defaults to main.
curl --request POST \
--url https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/object-links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"objectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/object-links"
payload = { "objectId": "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({objectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/object-links', 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({objectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/object-links', 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",
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"object_name": "<string>",
"object_type": "<string>",
"link_type": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"branch_name": "<string>",
"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.
132Path Parameters
Project id. May be compound in the form {projectId}--{branchName}.
1Agile card id.
Query Parameters
Branch containing the referenced object.
Body
Response
Current object-link record.
Hide child attributes
Hide child attributes
Latest committed card-history row ID; null only before a card has history.
Globally monotonic card-history sequence.
^\d+$