Skip to content

Lists the protocol bindings visible to the caller, filtered and paginated by the query.

GET
/v1/m/sessions/protocol-bindings
curl --request GET \
--url 'https://example.com/v1/m/sessions/protocol-bindings?protocol=a2a&verdict=CLEAN&limit=100' \
--header 'Authorization: Bearer <token>'

Lists the protocol bindings visible to the caller, filtered and paginated by the query.

X-Olivares-Tenant
string format: uuid

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

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_spec_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}$/

Exact ProtocolBindingSpec UUID filter.

work_item_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}$/

Exact WorkItem UUID filter.

protocol
string
Allowed values: a2a mcp

Exact protocol filter.

peer_authority
string
>= 1 characters <= 512 characters

Exact normalized peer authority filter.

owner_kind
string
>= 1 characters <= 512 characters

Exact normalized owner kind; owner_ref must be supplied with it.

owner_ref
string
>= 1 characters <= 512 characters

Exact owner reference; owner_kind must be supplied with it.

external_kind
string
>= 1 characters <= 512 characters

Exact normalized remote result-kind filter.

external_id
string
>= 1 characters <= 512 characters

Exact remote resource identifier filter.

verdict
string
Allowed values: CLEAN BROKEN UNKNOWN

Exact last-observation verdict filter.

terminal
boolean

Filter by terminal or non-terminal bindings.

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.

OK

Media type application/json
object
Example generated
{}

Bad request

Media type application/json
object
Example generated
{}

Unauthenticated

Media type application/json
object
Example generated
{}

Forbidden

Media type application/json
object
Example generated
{}

Not found

Media type application/json
object
Example generated
{}

Conflict / setup required

Media type application/json
object
Example generated
{}

Rate limited

Media type application/json
object
Example generated
{}