Card properties
The complete field list for a card. Most fields are CardBoard-only; only title and status sync to a tracker.
| Field | Type | Notes | Syncs |
|---|---|---|---|
| Title | text | The card’s name | ✅ |
| Status | enum | Not started / In progress / Done (plus backlog, review, archived) | ✅ |
| Custom status | text | A tracker status that doesn’t map to CardBoard’s enum | ✅ |
| Description | rich text | Long-form detail | ❌ |
| Acceptance criteria | rich text | Optional checklist/criteria | ❌ |
| Color | enum | color_name (e.g. blue, yellow); groups cards visually | ❌ |
| Shape | enum | rectangle, diamond, circle, capsule, parallelogram, cylinder | ❌ |
| Size | value | Optional sizing | ❌ |
| Width / height | number | Fixed card dimensions | ❌ |
| Position (x, y) | number | Meaning depends on the map type | ❌ |
| Parent card | reference | Hierarchy — load-bearing on tree/sitemap maps | ❌ |
| Assigned user | reference | Optional assignee | ❌ |
| Reactions | list | Emoji feedback | ❌ |
| Comments | list | Conversation threads | ❌ |
| Tracker links | list | Zero or more card↔tracker links | n/a |
| Outcomes | list | Named groups the card belongs to | ❌ |
Status values
Section titled “Status values”The full status set is none, unstarted, started, completed, backlog, review,
archived, and custom. The UI collapses these to three visible states — Not Started
(unstarted), In Progress (started), Done (completed) — and custom shows the
card’s custom_status text, used to mirror a tracker status that doesn’t fit CardBoard’s
enum.
What the API returns
Section titled “What the API returns”The REST API exposes: id, name, version, uuid, x, y, z_index, color_name, description, styled_description, status, custom_status, size, shape, fixed_width, fixed_height, created_at, updated_at, deleted_at, with optional comments, reactions, and
tracker_links. Note the public contract uses color_name (not the legacy color) and the
string shape.
For which of these survive a spreadsheet round-trip, see CSV import/export.