Skip to main content
GET
List every authored block in a workflow’s current draft. Returns the canonical { "data": [...], "list_metadata": { "before": null, "after": null } } pagination envelope shared with all Retab list endpoints. Cursor pagination is not yet implemented for this endpoint — list_metadata is always { before: null, after: null }. Use this endpoint with List Edges when you need to reconstruct a workflow graph.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

workflow_id
string
required
before
string | null

Block id cursor: return the page before this id (mutually exclusive with after).

after
string | null

Block id cursor: return the page after this id (mutually exclusive with before).

limit
integer
default:100

Maximum number of blocks to return per page (1-200).

Required range: 1 <= x <= 200

Response

Successful Response

A page of WorkflowBlock resources. data holds the items and list_metadata carries the before/after cursors; pass after to fetch the next page.

data
WorkflowBlock · object[]
required
list_metadata
ListMetadata · object
required

Boundary resource IDs for page navigation.