Skip to main content
GET
Get a dashboard draft

Authorizations

Authorization
string
header
required

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

Path Parameters

dashboardId
string<uuid>
required

A dashboard id.

Response

The draft.

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