Cards

Move a card within or across columns

A move within the same column is presentation: no ledger event, no Tre-Event-Seq, updatedAt untouched. A move across columns appends card.moved (the header carries its seq) and still never bumps the card's updatedAt.

post/api/cards/{cardId}/move

Request

  • Base URL: https://tre-app.com
  • URL: https://tre-app.com/api/cards/{cardId}/move
  • Auth: HTTP bearer

Request body

toListIdstring uuid required
toIndexinteger nullable required

Response

Success

idstring uuid required
boardIdstring uuid required
listIdstring uuid required
cardNumberinteger required
cardKeystring required
titlestring required
descriptionstring required
colorstring required
orderinteger required
startDatestring date nullable required
endDatestring date nullable required
scheduleState'unclassified' | 'planned' | 'suspended' | 'cancelled' required

Meaning of the retained schedule. Unclassified means its intent has not been reviewed; suspended/cancelled retain the plan for retrospective comparison.

actualStartDatestring date nullable required

Observed start, explicitly recorded from evidence. Independent of the schedule; null means unknown, never not started.

actualEndDatestring date nullable required

Observed end, explicitly recorded from evidence. May fall outside the plan. Null means unknown, never incomplete.

verifiedOnstring date nullable required

Day the named source was actually checked, never later than the server UTC day. Independent of updatedAt and the status date in the description; never advance for editorial work.

verificationSourcestring nullable required

Source reference and scope of the last factual verification (document, record, URL or cardKey). Set or clear together with verifiedOn.

createdAtstring date-time required
updatedAtstring date-time required
createdByUserIdstring uuid nullable required
assigneeUserIdsstring[] required
kind'control' | 'work' | 'reference' | 'decision' | 'digest' | 'guidance' nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.