CEceledon-solutions
Cards

Link a design object to a card

Changed on

Verifies an object in the current project branch, resolves its canonical name and type server-side, and records the branch-scoped reference in card history. branch overrides a branch embedded in the project id; otherwise the branch defaults to main.

post/api/v2/projects/{projectId}/cards/{cardId}/object-links

Request

  • Base URL
    https://davinci-app.com
  • Auth
    HTTP bearer

Query parameters

branchstring

Branch containing the referenced object.

Headers

If-Matchstring

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.

Request body

objectIdstring uuid required

Object verified in the current Project and selected branch.

linkType'related'
expectedHistoryHeadIdstring uuid nullable

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

Response

Current object-link record.

historyHeadIdstring uuid nullable required

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

historyHeadSequencestring nullable required

Globally monotonic card-history sequence.

Changes