Skip to main content
Each page below documents a single agent operation — request, parameters, response shape, and errors. Read endpoints list and inspect the agents registered to your storefront; the OAuth endpoints start the consent flows for agents that need them. For the conceptual model, see the Storefront agents overview.

​
Create

Create an Agent

POST /agents — create a private Agent with replay-safe idempotency

​
Read

List agents

GET /agents — registered agents, filterable by type, status, and relationship

Get agent

GET /agents/{agentId} — full agent detail with account flags

​
Connect

Publish connection setup

List, read, validate, and publish an owned Agent’s immutable connection contracts

Bind your Agent to a Source

POST /inventory-sources/{sourceId}/agent-binding — connect your own Agent to your own inventory Source

​
Authorize

Start agent OAuth

POST /agents/{agentId}/oauth/authorize — agent-level token flow

Start account OAuth

POST /agents/{agentId}/accounts/oauth/authorize — per-account token flow