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>",
"requiredCardFields": [
"name"
],
"requiredFieldsCompliant": true,
"missingRequiredFields": [
"name"
],
"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",
"status_assign_mover_on_entry": true,
"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>",
"description": "<string>",
"color": "<string>",
"transitionState": "not_started",
"closeMode": "off",
"assignMoverOnEntry": true,
"requiredCardFields": [
"name"
]
}
],
"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": {}
}
}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.
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>",
"requiredCardFields": [
"name"
],
"requiredFieldsCompliant": true,
"missingRequiredFields": [
"name"
],
"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",
"status_assign_mover_on_entry": true,
"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>",
"description": "<string>",
"color": "<string>",
"transitionState": "not_started",
"closeMode": "off",
"assignMoverOnEntry": true,
"requiredCardFields": [
"name"
]
}
],
"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}.
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.
10000Unit-agnostic estimate, commonly interpreted as story points or hours.
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.
10000Unit-agnostic estimate, commonly interpreted as story points or hours.
x >= 0relates_to, depends_on 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
User-editable scalar card field that a workflow status may require.
name, description, resolution, deadline, effort User-editable scalar card field that a workflow status may require.
name, description, resolution, deadline, effort summary exposes only bounded Team, status, and sprint identifiers
and labels when the Project Card reader cannot otherwise read the Team.
full, summary Team lifecycle status; active is the database default.
private, internal Automatic close-on-entry behavior for a workflow status. The bulk close
action is available for every status. off leaves card state unchanged
on entry, while automatic closes open cards on entry. manual is a
deprecated legacy value with the same entry behavior as off.
add_mover_to_assignees is a deprecated write alias that stores
closeMode=off with assignMoverOnEntry=true; reads never return that
alias.
off, manual, automatic, add_mover_to_assignees Number of team placements; closing State remains global and does not move any placement.
x >= 0Hide child attributes
Hide child attributes
50Hide child attributes
Hide child attributes
Globally monotonic card-history sequence.
^\d+$card, sprint, team, status 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.
^\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.
10000Unit-agnostic estimate, commonly interpreted as story points or hours.
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
not_started, started, closed Automatic close-on-entry behavior for a workflow status. The bulk close
action is available for every status. off leaves card state unchanged
on entry, while automatic closes open cards on entry. manual is a
deprecated legacy value with the same entry behavior as off.
add_mover_to_assignees is a deprecated write alias that stores
closeMode=off with assignMoverOnEntry=true; reads never return that
alias.
off, manual, automatic, add_mover_to_assignees When true, entering this status adds the authenticated mover as an assignee without removing existing assignees.
User-editable scalar card field that a workflow status may require.
name, description, resolution, deadline, effort Hide child attributes
Hide child attributes