Cards

Restore a card from the trash

Returns the card to its original list if that list still exists, otherwise the leftmost list of the board, at the bottom. A second call on a live card is a no-op. 409 CONFLICT means the lists the restore chose were deleted before it could write, 3 attempts in a row: the card is still in the trash, and the same call can be sent again.

post/api/cards/{cardId}/restore

Request

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

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.