Skip to main content
GET
List the Procedure Builder conversation
One page of the version’s current Builder conversation, oldest first, and the turn’s state. Items are a person’s messages (person), the Builder’s replies (builder) and platform notices (notice): a retry, a stop, a continuation that did not run because another turn was running. Tool calls, failure details and validation reports are never included; a message fenced to knowledge or companies keeps its place with withheld: true and text: null. A draft’s name and version can change while it is built: the Builder names a new draft, and a version floor correction can raise a draft’s version. Each answer names the draft’s current procedureId and version; use those. An earlier name keeps working, and so does a version the draft was corrected past. turn.state is none (no conversation), idle (ready for a message), or running, queued or stopping (a turn is in progress). Pass meta.nextCursor as cursor for the next page; limit is 1–50 (default 20). You need procedures:write at the version’s home (a version with no home: the platform scope); a version out of reach is the same 404 resource_missing as a missing one. Every credential kind may call it.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

procedureId
string
required

The procedure family's id.

Minimum string length: 1

Query Parameters

version
string
required

The semver version.

Minimum string length: 1
cursor
string

The meta.nextCursor of the previous page.

Minimum string length: 1
limit
integer

Page size, 1–50 (default 20).

Required range: 1 <= x <= 50

Response

Success

data
object
required

One page of the version's current Builder conversation, oldest first: a person's messages, the Builder's replies and platform notices. Tool calls, failure details and validation reports are never included (read validation with getLatestValidationRun).

meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.