Lists protocol binding spec generations in one workspace.

GET

/v1/m/sessions/protocol-binding-specs

curl --request GET \
  --url 'https://example.com/v1/m/sessions/protocol-binding-specs?protocol=a2a&direction=inbound&local_kind=work_item&state=draft&limit=100' \
  --header 'Authorization: Bearer <token>'

• this engine

Lists protocol binding spec generations in one workspace. An empty page is returned as an empty array rather than null.

Authorizations

• bearerAuth

Parameters

Header Parameters

X-Olivares-Tenant

string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Query Parameters

workspace_id

string format: uuid

/^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/

Workspace UUID. It may be omitted only when the authenticated principal is confined to one workspace.

binding_key

string

>= 1 characters <= 128 characters

Exact normalized binding-key filter.

generation

integer format: int64

>= 1

Exact immutable spec generation.

protocol

string

Allowed values: a2a mcp

Exact protocol filter.

direction

string

Allowed values: inbound outbound bidirectional

Exact binding direction filter.

local_kind

string

Allowed values: work_item agent model channel

Exact local resource-kind filter.

peer_authority

string

>= 1 characters <= 512 characters

Exact normalized peer authority filter.

state

string

Allowed values: draft active disabled superseded

Exact spec lifecycle-state filter.

limit

integer

default: 100 >= 1 <= 200

Keyset page size from 1 through 200; default 100.

cursor

string format: uuid

/^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/

Opaque UUIDv7 keyset cursor returned by the previous page.

Responses

200

OK

Media type application/json

object

Example ^generated

{}

400

Bad request

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Forbidden

Media type application/json

object

Example ^generated

{}

404

Not found

Media type application/json

object

Example ^generated

{}

409

Conflict / setup required

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}