Skip to main content
GET
List the workflows that pin a procedure version
Returns one page of the published workflow versions whose graph pins this exact procedureId and version, each once with its workflowVersionId and the names of the pinning nodes: who depends on the version an author is about to change. Draft nodes are not callers, because only a published version runs. A workflow with several published versions that pin it is listed once per version. This is the list the Procedure Builder shows before you refine a version.

Who may read

  • You need procedures:write (the procedure author permission) at the version’s home org unit. A missing version and one out of reach are the same 404 resource_missing.
  • A workflow is listed only when you may read it (workflows:read at its home).

Paging

Every caller is listed: page with limit (1 to 100, default 100) and cursor, following meta.nextCursor while meta.hasMore is true. A page reads a bounded number of nodes, so it can hold fewer callers than limit, or none, while meta.hasMore is true. A malformed limit or cursor is 400 bad_request.

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
limit
integer
default:100

Items per page, 1 to 100 (default 100); a larger value is a 400 too_big. A page may hold fewer items than limit while meta.hasMore is true; continue with meta.nextCursor.

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

The previous page's meta.nextCursor; any other value is 400.

Minimum string length: 1

Response

Success

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.