Get an agent message run
curl --request GET \
--url https://omnicommerce.ai/api/v1/agents/{agentId}/runs/{runId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://omnicommerce.ai/api/v1/agents/{agentId}/runs/{runId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://omnicommerce.ai/api/v1/agents/{agentId}/runs/{runId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"agentId": "<string>",
"threadKey": "<string>",
"runId": "<string>",
"threadId": "<string>",
"status": "accepted",
"reply": "<string>",
"approvals": [
{
"interrupt_instance_id": "<string>",
"tool_name": "<string>",
"tool_args": "<unknown>",
"message": "<string>"
}
],
"error": "<string>"
}Agents
Get an agent message run
Read an agent message run belonging to the authenticated caller and the exact agent in the URL. Current organization membership and agent sharing are checked again. Requires agents:invoke.
GET
/
api
/
v1
/
agents
/
{agentId}
/
runs
/
{runId}
Get an agent message run
curl --request GET \
--url https://omnicommerce.ai/api/v1/agents/{agentId}/runs/{runId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://omnicommerce.ai/api/v1/agents/{agentId}/runs/{runId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://omnicommerce.ai/api/v1/agents/{agentId}/runs/{runId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"agentId": "<string>",
"threadKey": "<string>",
"runId": "<string>",
"threadId": "<string>",
"status": "accepted",
"reply": "<string>",
"approvals": [
{
"interrupt_instance_id": "<string>",
"tool_name": "<string>",
"tool_args": "<unknown>",
"message": "<string>"
}
],
"error": "<string>"
}Authorizations
Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.
Query Parameters
Required for sign-in sessions. API keys already identify their organization.
Maximum string length:
120Response
Current run status, reply and approvals.