Skip to main content
POST
/
agents
/
{agentId}
/
capabilities
/
refresh
Refresh agent capabilities
curl --request POST \
  --url https://api.interchange.io/api/v2/storefront/agents/{agentId}/capabilities/refresh \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.interchange.io/api/v2/storefront/agents/{agentId}/capabilities/refresh"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.interchange.io/api/v2/storefront/agents/{agentId}/capabilities/refresh', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "version": "<string>",
  "protocols": [
    "<string>"
  ],
  "tools": [
    "<string>"
  ],
  "requireOperatorAuth": true,
  "defaultBilling": "<string>",
  "supportedBillings": [
    "<string>"
  ]
}
{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}
{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}
{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

agentId
string
required
Minimum string length: 1

Response

Refresh agent capabilities

version
string
required

AdCP capabilities version reported by the agent.

protocols
string[]
required

Protocols the agent speaks (e.g. mcp, a2a).

tools
string[]
required

Full list of tool names the agent reports.

requireOperatorAuth
boolean
required

Whether the agent requires operator-level auth.

defaultBilling
string | null
required

Default billing type, or null when not reported.

supportedBillings
string[]
required

Billing types the agent supports.

{key}
any