Skip to main content
GET
Diagnose a procedure version's connection bindings
Returns what Console’s connection binding editor shows for one version: for each binding, in authored order, whether it resolves a Credential (outcome: resolvable, missing_binding or connection_not_provisioned), the next step, and the vendor’s connections with their descriptions, hosts and auth schemes; then the fail-closed aggregate, candidate vendors for an unbound version (from its egress hosts) and the egress allowlist. No credential value is returned.

Who may read

  • You need procedures:manage at the version’s home org unit. A missing version and one out of reach are the same 404 resource_missing.
  • orgUnitId chooses whose Credentials are consulted. You need procedures:manage there too; otherwise 404.
Change the bindings with Set a procedure version’s connections.

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
orgUnitId
string

Consult this org unit's Credentials.

Minimum string length: 1

Response

Success

data
object
required

Whether each of the version's connection bindings resolves a Credential, in authored order, and the fail-closed aggregate, with each vendor's connections to choose from. Names vendors, connections and hosts; never a credential value.

meta
object
required