Organization Whiteboards

Organization whiteboards give each organization one simple kanban-style board. Notes are text-only post-it items with a background color, a position, and exactly one active column.

The API records every note and column mutation as an immutable event. Events include the actor, action, timestamp, sequence number, before/after note or column state, and a complete board snapshot after the change.

Endpoints

Board state and history:

• GET /v1/orgs/{organizationId}/whiteboard
• GET /v1/orgs/{organizationId}/whiteboard?at=2026-05-31T12:00:00Z
• GET /v1/orgs/{organizationId}/whiteboard/history
• GET /v1/orgs/{organizationId}/whiteboard/history?noteId={noteId}

Note operations:

• POST /v1/orgs/{organizationId}/whiteboard/notes
• PATCH /v1/orgs/{organizationId}/whiteboard/notes/{noteId}
• POST /v1/orgs/{organizationId}/whiteboard/notes/{noteId}/move
• DELETE /v1/orgs/{organizationId}/whiteboard/notes/{noteId}

Column operations:

• POST /v1/orgs/{organizationId}/whiteboard/columns
• PATCH /v1/orgs/{organizationId}/whiteboard/columns/{columnId}
• POST /v1/orgs/{organizationId}/whiteboard/columns/reorder
• DELETE /v1/orgs/{organizationId}/whiteboard/columns/{columnId}

Permissions

Any organization member can read the board and event history.

Members with User or above can create, edit, move, and delete notes. Viewer and Worker members are read-only for notes.

Only Admin and Owner members can create, rename, reorder, and delete columns. A column with active notes cannot be deleted.

Notes

Create a note:

{
  "columnId": "22222222-2222-2222-2222-222222222222",
  "text": "Call client before handover",
  "color": "#FDE68A"
}

text is trimmed and limited to 4000 characters. color accepts #RGB or #RRGGBB and is normalized to uppercase #RRGGBB. Omit position to append the note to the target column.

Move a note:

{
  "columnId": "44444444-4444-4444-4444-444444444444",
  "position": 2
}

Timeline

Use GET /v1/orgs/{organizationId}/whiteboard/history to build a board timeline. Events are returned by sequence ascending and can be filtered with noteId for a single note timeline.

Use GET /v1/orgs/{organizationId}/whiteboard?at={timestamp} to request the board state at a past UTC time. The response is the latest complete board snapshot at or before that timestamp, including note text and colors as they existed then.