Skip to main content
GET
Get one procedure version
Returns one procedure version the caller may read, with its dispatch usage, hard-delete blockers and whether any version of the family is used by a current workflow. Without version, the highest visible active version. A missing procedure and one the caller may not read are both 404 resource_missing. See Procedure catalog.

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
Minimum string length: 1

Query Parameters

version
string

Defaults to the highest-semver active version the caller may read, else the highest-semver version the caller may read.

Response

Procedure version detail

data
object
required

One procedure version the caller may read. usage is folded over the versions the caller may read; retirement.blockers are this version's hard-delete blockers; familyReferencedByCurrentWorkflow is whether any version of the family is used by a live draft or active workflow version (null when the bounded check could not decide). Versions never change after they are minted (immutable). Never carries source, creators, lifecycle actors, repository state or connection bindings.

meta
object
required