Skip to main content
A storefront agent is a partner agent registered to your storefront — a sales/media agent, a signal/data agent, a creative agent, or an outcome measurement agent. Each agent carries capability metadata (type, protocol, authenticationType), a lifecycle status, and a relationship that tells you whether you own it (SELF) or it belongs to the wider marketplace (MARKETPLACE). You list and inspect agents to decide which ones power your storefront and which need credentials. Agents that use OAuth need an interactive consent flow before the platform can call them. There are two flows: agent-level OAuth stores tokens in the agent configuration for platform-to-agent calls, and per-account OAuth stores tokens against the buyer/operator account the grant represents. Both return an authorizationUrl you send the operator to. All examples use the storefront base URL: 
https://api.interchange.io/api/v2/storefront
Authenticate every request with Authorization: Bearer $SCOPE3_API_KEY.

​
Task reference

List agents

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

Get agent

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

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