Skip to main content
PATCH
Update or move a planning card

Authorizations

Authorization
string
header
required

An API key from the web app (Settings → Developer), sent as Authorization: Bearer rvl_live_….

Path Parameters

projectId
string
required

Project id, proj_….

cardId
string
required

Planning card id, card_….

Body

application/json
title
string
Required string length: 1 - 200
description
string | null

The card's description, in format; null clears it.

Maximum string length: 90000
format
enum<string>
default:markdown

markdown (default) or html. Descriptions are stored as HTML from the web app's editor. Markdown is converted both ways; it drops colours, font sizes and alignment. HTML is sanitised to what the editor itself produces.

Available options:
markdown,
html
engine
string | null

Engine slug; null clears it.

Required string length: 1 - 64
plannedStart
string<date> | null

Planned start (YYYY-MM-DD); null clears it.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
plannedEnd
string<date> | null

Planned end (YYYY-MM-DD); null clears it.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
assignee
string | null

A user_… id or an email of the project's owner or a member; null unassigns.

Required string length: 1 - 320
columnId
string

Move the card to this column (col_…).

position
integer

0-based position in the column (the card's current one if columnId is left out). Without it, a moved card goes to the end.

Required range: 0 <= x <= 9007199254740991

Response

OK

id
string
required

Card id, card_….

type
enum<string>
required

planned: work to do, with linkedRuns. run: tracks run.

Available options:
planned,
run
title
string
required
column
object
required
position
number
required

0-based position in the column.

engine
string | null
required

Engine slug the work is planned for; null if none, or for engines the API doesn't expose.

plannedStart
string | null
required

YYYY-MM-DD.

plannedEnd
string | null
required

YYYY-MM-DD.

assignee
object | null
required
createdBy
object
required
run
object | null
required

The run a run card tracks; null for planned cards, or once the run is deleted.

linkedRuns
object[]
required

Runs linked to a planned card, oldest link first.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
format
enum<string>
required
Available options:
markdown,
html
description
string | null
required

The card's description, in format.