Get card details
curl --request GET \
--url https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/details \
--header 'Authorization: Bearer <token>'import requests
url = "https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/details"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"card": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"resolution": "<string>",
"created_by_user": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deadline": "2023-11-07T05:31:56Z",
"is_open": true,
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"effort": 1,
"author_display_name": "<string>",
"closed_at": "2023-11-07T05:31:56Z"
},
"tags": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"color": "<string>",
"status": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"userLinks": [
{
"link_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display_name": "<string>",
"relation_type": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}
],
"linkedCards": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"resolution": "<string>",
"created_by_user": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deadline": "2023-11-07T05:31:56Z",
"is_open": true,
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"effort": 1,
"link_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"link_type": "relates_to",
"direction": "outgoing",
"author_display_name": "<string>",
"closed_at": "2023-11-07T05:31:56Z"
}
],
"objectLinks": [
{
"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"
}
],
"teams": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"sprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sprint_name": "<string>",
"status_name": "<string>",
"placementAccess": "full",
"description": "<string>",
"status": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"visibility": "private",
"status_color": "<string>",
"status_close_mode": "off",
"org_handle": "<string>",
"org_slug": "<string>"
}
],
"teamPlacementCount": 1,
"comments": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"body": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"author_display_name": "<string>"
}
],
"history": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"sequence": "<string>",
"entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "card",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type": "created",
"event_data": {},
"author_display_name": "<string>"
}
],
"historyHeadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"historyHeadSequence": "<string>",
"historyContext": {
"users": {},
"tags": {},
"cards": {},
"references": {}
},
"teamOptions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organizationName": "<string>",
"statuses": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"transitionState": "not_started",
"closeMode": "off"
}
],
"sprints": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"status": "planned",
"startDate": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z"
}
],
"isPlaced": true
}
]
}{
"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": {}
}
}Cards
Get card details
Returns the card with tags, users, linked cards, design-object references, team placements, the newest 50 comments, and up to 50 newest history events. Use the paginated comment/history routes to continue older timelines.
GET
/
api
/
v2
/
projects
/
{projectId}
/
cards
/
{cardId}
/
details
Get card details
curl --request GET \
--url https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/details \
--header 'Authorization: Bearer <token>'import requests
url = "https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/details"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"card": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"resolution": "<string>",
"created_by_user": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deadline": "2023-11-07T05:31:56Z",
"is_open": true,
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"effort": 1,
"author_display_name": "<string>",
"closed_at": "2023-11-07T05:31:56Z"
},
"tags": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"color": "<string>",
"status": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"userLinks": [
{
"link_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display_name": "<string>",
"relation_type": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}
],
"linkedCards": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"resolution": "<string>",
"created_by_user": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deadline": "2023-11-07T05:31:56Z",
"is_open": true,
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"effort": 1,
"link_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"link_type": "relates_to",
"direction": "outgoing",
"author_display_name": "<string>",
"closed_at": "2023-11-07T05:31:56Z"
}
],
"objectLinks": [
{
"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"
}
],
"teams": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"sprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sprint_name": "<string>",
"status_name": "<string>",
"placementAccess": "full",
"description": "<string>",
"status": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"visibility": "private",
"status_color": "<string>",
"status_close_mode": "off",
"org_handle": "<string>",
"org_slug": "<string>"
}
],
"teamPlacementCount": 1,
"comments": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"body": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"author_display_name": "<string>"
}
],
"history": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"timestamp": "2023-11-07T05:31:56Z",
"sequence": "<string>",
"entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "card",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type": "created",
"event_data": {},
"author_display_name": "<string>"
}
],
"historyHeadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"historyHeadSequence": "<string>",
"historyContext": {
"users": {},
"tags": {},
"cards": {},
"references": {}
},
"teamOptions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organizationName": "<string>",
"statuses": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"transitionState": "not_started",
"closeMode": "off"
}
],
"sprints": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"status": "planned",
"startDate": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z"
}
],
"isPlaced": true
}
]
}{
"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.
Path Parameters
Project id. May be compound in the form {projectId}--{branchName}.
Minimum string length:
1Agile card id.
Response
Composite card details.
Hide child attributes
Hide child attributes
Optional Markdown resolution; closing or reopening the card does not clear it.
Maximum string length:
10000Unit-agnostic estimate, commonly interpreted as story points or hours.
Required range:
x >= 0Display name of the user who created the card, when available.
Timestamp of the latest transition to the closed state; null while open.
Hide child attributes
Hide child attributes
Optional Markdown resolution; closing or reopening the card does not clear it.
Maximum string length:
10000Unit-agnostic estimate, commonly interpreted as story points or hours.
Required range:
x >= 0Available options:
relates_to, depends_on Available options:
outgoing, incoming Display name of the user who created the card, when available.
Timestamp of the latest transition to the closed state; null while open.
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
summary exposes only bounded Team, status, and sprint identifiers
and labels when the Project Card reader cannot otherwise read the Team.
Available options:
full, summary Team lifecycle status; active is the database default.
Available options:
private, internal Available options:
off, manual, automatic Number of team placements; closing State remains global and does not move any placement.
Required range:
x >= 0Hide child attributes
Hide child attributes
Maximum array length:
50Hide child attributes
Hide child attributes
Globally monotonic card-history sequence.
Pattern:
^\d+$Available options:
card, sprint, team, status Available options:
created, deleted, opened, closed, ownership_transfer_requested, ownership_transfer_declined, ownership_transferred, field_updated, status_changed, sprint_added, sprint_removed, team_added, team_removed, card_added, card_removed, tag_added, tag_removed, user_link_added, user_link_removed, reference_added, reference_removed, card_link_added, card_link_removed, card_mentioned, comment_added, comment_updated, comment_deleted For field_updated, field may be resolution and old/new carry the Markdown values.
Latest committed card-history row ID; null only before a card has history.
Globally monotonic card-history sequence.
Pattern:
^\d+$Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Optional Markdown resolution; closing or reopening the card does not clear it.
Maximum string length:
10000Unit-agnostic estimate, commonly interpreted as story points or hours.
Required range:
x >= 0Display name of the user who created the card, when available.
Timestamp of the latest transition to the closed state; null while open.
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Available options:
not_started, started, closed Available options:
off, manual, automatic Hide child attributes
Hide child attributes