Refresh agent capabilities
curl --request POST \
--url https://api.interchange.io/api/v2/storefront/agents/{agentId}/capabilities/refresh \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.interchange.io/api/v2/storefront/agents/{agentId}/capabilities/refresh"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
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": {}
}
}Storefront Agents
Refresh agent capabilities
Re-probe a registered agent and refresh its stored capabilities snapshot (protocols, tools, formats). Returns the refreshed capabilities.
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>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.interchange.io/api/v2/storefront/agents/{agentId}/capabilities/refresh"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
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
API key or access token
Path Parameters
Minimum string length:
1Body
application/json
Exact Storefront inventory Source ID to refresh when the Agent identity is shared by multiple Sources
Minimum string length:
1Response
Refresh agent capabilities
AdCP capabilities version reported by the agent.
Protocols the agent speaks (e.g. mcp, a2a).
Full list of tool names the agent reports.
Whether the agent requires operator-level auth.
Default billing type, or null when not reported.
Billing types the agent supports.