Skip to main content
PATCH
Edit a dashboard draft

Authorizations

Authorization
string
header
required

An API key (utk_live_...) or an app's OAuth access token (uto_...).

Headers

Idempotency-Key
string

Any 1 to 255 printable ASCII characters, without a space at either end. The answer to the first request with a key is kept for 24 hours per credential: the same request again gets it back (Idempotent-Replayed: true), another request with the key is 409 PUB-002-002, and while the first still runs 409 PUB-002-003. A server error is not kept, and a request that never answered frees its key after 2 minutes: a retry with the key then runs again.

Maximum string length: 255

Path Parameters

dashboardId
string<uuid>
required

A dashboard id.

Body

application/json
expectedDraftVersion
integer
required

draftVersion from the last read. Missing is 400 PUB-001-004.

Required range: x >= 0
operations
object[]
required

1 to 50 changes, applied in order and saved together or not at all.

Required array length: 1 - 50 elements

One change to the draft.

Response

The draft after the edit.

id
string<uuid>
required
name
string
required
description
string | null
required
icon
string | null
required
color
string | null
required
visibility
enum<string>
required
Available options:
organization,
private
isDefault
boolean
required
readOnlyByPlan
boolean
required
hasUnpublishedChanges
boolean
required

True while the draft holds changes viewers don't see yet.

draftVersion
integer
required

Send it back as expectedDraftVersion on the next edit.

editable
boolean
required
cards
object[]
required

The draft's cards (the published ones while nothing waits).

url
string<uri>
required
editorUrl
string<uri>
required

Opens the board in edit mode in Usertick, where a person reviews the draft and selects Publish.

draftUpdatedAt
string<date-time> | null
required
Example:

"2026-09-30T10:00:00.000Z"

createdAt
string<date-time>
required
Example:

"2026-09-30T10:00:00.000Z"

updatedAt
string<date-time> | null
required
Example:

"2026-09-30T10:00:00.000Z"

aiGenerated
boolean
required
aiGeneratedAt
string<date-time> | null
required

When text Usertick AI wrote was first stored here; null when people wrote all of it.

Example:

"2026-09-30T10:00:00.000Z"

Last modified on November 9, 2026