Move a board card between sprints

curl --request PATCH \
  --url https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/sprint-link \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sprintId": null,
  "expectedHistoryHeadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/sprint-link"

payload = {
    "sprintId": None,
    "expectedHistoryHeadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sprintId: null, expectedHistoryHeadId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/sprint-link', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sprintId: null, expectedHistoryHeadId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/sprint-link', 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": {}
  }
}

PATCH

api

orgs

{orgId}

teams

{teamId}

cards

{cardId}

sprint-link

Move a board card between sprints

curl --request PATCH \
  --url https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/sprint-link \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sprintId": null,
  "expectedHistoryHeadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/sprint-link"

payload = {
    "sprintId": None,
    "expectedHistoryHeadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sprintId: null, expectedHistoryHeadId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/sprint-link', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sprintId: null, expectedHistoryHeadId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/cards/{cardId}/sprint-link', 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

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.

Headers

If-Match

string

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.

Maximum string length: 132

Path Parameters

orgId

string<uuid>

required

Organization id.

teamId

string<uuid>

required

Agile team id.

cardId

string<uuid>

required

Agile card id.

Body

application/json

sprintId

string<uuid> | null

Null moves the card to the backlog.

expectedHistoryHeadId

string<uuid> | null

Latest committed card-history row ID; null only before a card has history.

Response

Updated board placement.

link

object

required

Hide child attributes

link.id

string<uuid>

required

link.card_id

string<uuid>

required

link.team_id

string<uuid>

required

link.sprint_id

string<uuid> | null

required

link.status_id

string<uuid> | null

required

link.created_at

string<date-time> | null

required

historyHeadId

string<uuid> | null

required

Latest committed card-history row ID; null only before a card has history.

historyHeadSequence

string | null

required

Globally monotonic card-history sequence.

Pattern: ^\d+$

Getting Started

Davinci Browser

Davinci Editor

Integrations

Modeling Guide

Developer API

Examples

Release Notes

Move a board card between sprints

Authorizations

Headers

Path Parameters

Body

Response