Update a card (metadata + drag-drop)

patch/cards/{id}

Request

  • Base URL: https://craaft.io/api/v1
  • URL: https://craaft.io/api/v1/cards/{id}
  • Auth: HTTP bearer

Request body

titlestring
descriptionstring
columnstring
positionnumber
dueDatestring date-time nullable
assignedUserIdstring uuid nullable
sizeinteger nullable
priority'low' | 'medium' | 'high' | 'urgent' | 'null' nullable
tagsstring[]

Replaces the card's tag set when present. Send [] to clear.

Response

Updated

idstring uuid required
projectIdstring uuid required
columnstring required
titlestring required
descriptionstring

Full body on GET /cards/{id}, PATCH, create, and /detail. Omitted from GET /projects/{id}/cards and lean SSE card.updated events (position-only moves).

positionnumber required
dueDatestring date-time nullable
assignedUserIdstring uuid nullable
assignedUserNamestring nullable
sizeinteger nullable

Optional integer size estimate; null when unset

priority'low' | 'medium' | 'high' | 'urgent' | 'null' nullable
createdBystring uuid nullable
createdByNamestring nullable
updatedBystring uuid nullable
updatedByNamestring nullable
attachmentCountinteger
checklistDoneinteger

Completed checklist items (denormalized count)

checklistTotalinteger

Total checklist items (denormalized count)

tagsstring[]
followingboolean

Whether the authenticated caller follows this card

createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.