Atomically create and place a Project Card

curl --request POST \
  --url https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/project-cards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>"
}
'

import requests

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

payload = {
    "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
}
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({projectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a', name: '<string>'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/project-cards', 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({projectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a', name: '<string>'})
};

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

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

Teams

Atomically create and place a Project Card

Creates a Project-owned Card, optionally assigns an effective Project member, links the Project when separately authorized, and places the Card on this Team board in one transaction. The selected Status and Sprint policy are revalidated under the Team lock before any row is inserted. A status with assignMoverOnEntry assigns the caller, using the API key’s owning user for API-key requests. Destination required fields are enforced unless explicitly bypassed.

POST

api

orgs

{orgId}

teams

{teamId}

project-cards

Atomically create and place a Project Card

curl --request POST \
  --url https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/project-cards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>"
}
'

import requests

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

payload = {
    "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
}
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({projectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a', name: '<string>'})
};

fetch('https://davinci-app.com/api/v2/orgs/{orgId}/teams/{teamId}/project-cards', 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({projectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a', name: '<string>'})
};

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

{
  "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

Idempotency-Key

string

A value you choose to identify this request, so that retrying it does not repeat its effect. Reuse the same key when retrying and the original result is returned; use a fresh key when you mean to create something new. Keys are scoped to the API key that sent them (or to the user for browser sessions). Replayed responses include Idempotency-Replayed: true.

Maximum string length: 255

Path Parameters

orgId

string<uuid>

required

Organization id.

teamId

string<uuid>

required

Agile team id.

Body

application/json

projectId

string<uuid>

required

name

string

required

Sanitized by the server to a resource name of at most 255 characters.

description

string | null

resolution

string | null

Maximum string length: 10000

deadline

string<date-time> | null

effort

integer | null

Required range: x >= 0

assigneeId

string<uuid> | null

deprecated

Use assigneeIds.

assigneeIds

string<uuid>[]

Maximum array length: 50

tagIds

string<uuid>[]

Maximum array length: 50

cardLinks

object[]

Maximum array length: 50

Hide child attributes

cardLinks.cardId

string<uuid>

required

cardLinks.linkType

enum<string>

default:relates_to

Available options:

relates_to,

depends_on,

dependency_of

statusId

string<uuid> | null

Defaults to the Team's first not-started Status.

sprintId

string<uuid> | null

Planned or active Sprint; null places the Card in the backlog.

bypassRequiredFields

boolean

default:false

Explicitly create the card despite missing destination-status fields.

Response

Project Card, Team placement, and current history head.

card

object

required

Hide child attributes

card.id

string<uuid>

required

card.name

string

required

card.description

string | null

required

card.resolution

string | null

required

Optional Markdown resolution; closing or reopening the card does not clear it.

Maximum string length: 10000

card.created_by_user

string<uuid> | null

required

card.created_at

string<date-time> | null

required

card.updated_at

string<date-time> | null

required

card.deadline

string<date-time> | null

required

card.is_open

boolean

required

card.project_id

string<uuid>

required

card.effort

integer | null

required

Unit-agnostic estimate, commonly interpreted as story points or hours.

Required range: x >= 0

card.author_display_name

string | null

Display name of the user who created the card, when available.

card.closed_at

string<date-time> | null

read-only

Timestamp of the latest transition to the closed state; null while open.

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

Administration

Developer API

Examples

Release Notes

Atomically create and place a Project Card

Authorizations

Headers

Path Parameters

Body

Response