Skip to main content
GET
List the published workflows that pin an agent
Use this before rolling an agent back or editing it: each row is one node of a published workflow version, with the version it pins. Drafts are never listed, and a workflow you may not read at its home is left out. See Versions and rollback.

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

agentId
string
required

Query Parameters

version
string

Return only nodes pinned to exactly this version. A node published before pinning never matches.

Minimum string length: 1
limit
integer
default:50

Graph nodes to scan for this page, 1 to 50; a larger value is 400 too_big.

Required range: 1 <= x <= 50
cursor
string

The opaque meta.nextCursor from the previous page.

Minimum string length: 1

Response

Agent consumers

data
object[]
required
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.