List card history

curl --request GET \
  --url https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/history \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/history"

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}/history', 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}/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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>"
    }
  ],
  "meta": {
    "limit": 2,
    "offset": 1,
    "hasMore": true,
    "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": {}
  }
}

GET

api

projects

{projectId}

cards

{cardId}

history

List card history

curl --request GET \
  --url https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/history \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://davinci-app.com/api/v2/projects/{projectId}/cards/{cardId}/history"

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}/history', 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}/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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>"
    }
  ],
  "meta": {
    "limit": 2,
    "offset": 1,
    "hasMore": true,
    "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": {}
  }
}

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.

Path Parameters

projectId

string

required

Project id. May be compound in the form {projectId}--{branchName}.

Minimum string length: 1

cardId

string<uuid>

required

Agile card id.

Query Parameters

limit

integer

default:50

Required range: 1 <= x <= 100

offset

integer

default:0

Required range: x >= 0

Response

One page of card history events.

history

object[]

required

Hide child attributes

history.id

string<uuid>

required

history.project_id

string<uuid> | null

required

history.org_id

string<uuid> | null

required

history.team_id

string<uuid> | null

required

history.timestamp

string<date-time> | null

required

history.sequence

string

required

Globally monotonic card-history sequence.

Pattern: ^\d+$

history.entity_id

string<uuid>

required

history.entity_type

enum<string>

required

Available options:

card,

sprint,

team,

status

history.user_id

string<uuid> | null

required

history.event_type

enum<string>

required

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

history.event_data

object

required

For field_updated, field may be resolution and old/new carry the Markdown values.

history.author_display_name

string | null

required

Getting Started

Davinci Browser

Davinci Editor

Integrations

Modeling Guide

Developer API

Examples

Release Notes

List card history

Authorizations

Path Parameters

Query Parameters

Response