Skip to main content
GET
Get a workflow

Authorizations

Authorization
string
header
required

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

Path Parameters

workflowId
string<uuid>
required

A workflow id.

Response

The workflow.

id
string<uuid>
required
name
string
required
status
enum<string>
required
Available options:
draft,
active,
disabled,
paused
hasUnpublishedChanges
boolean
required

The draft holds changes that don't run yet.

draftVersion
integer
required

Send it back as expectedDraftVersion on the next edit.

draft
object
required

The workflow as its editor holds it, at most 512 KB stored.

Example:
published
object | null
required

What runs now; null while the workflow was never published.

Example:
pausedReason
string | null
required
pausedAt
string<date-time> | null
required
Example:

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

publishIssues
object[]
required

What a person must finish before publishing, each on its step (null for the trigger or the whole flow).

warnings
object[]
required

What publishing allows but the person should see.

editorUrl
string<uri>
required

Opens the workflow editor in Usertick, where a person publishes the workflow, which also turns it on.

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