Returns model runs for the authenticated agent, ordered from newest to oldest. Usage, cost, and billing data are not exposed.
api.heroui.pro/v1/agents/{agentId}/runsSend the request to see the live response from the Agents API.
A workspace API key with the permission required by the operation. It may target any active Agent in its workspace.
In: header
The Agent targeted by this workspace API key request.
The maximum number of objects to return. Defaults to 20 and is capped at 100.
201 <= value <= 100An opaque cursor returned by the previous page.
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.heroui.pro/v1/agents/string/runs"{
"data": [
{
"completed_at": "2019-08-24T14:15:22Z",
"component_kinds": [
"string"
],
"conversation_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"effort": "string",
"error_code": "string",
"failed_tool_names": [
"string"
],
"first_chunk_at": "2019-08-24T14:15:22Z",
"id": "string",
"metadata": {
"property1": "string",
"property2": "string"
},
"model_id": "string",
"object": "run",
"request_id": "string",
"sdk_version": "string",
"status": "aborted",
"timing": {},
"tool_errors": [
{
"code": "string",
"message": "string",
"tool_call_id": "string",
"tool_name": "string"
}
],
"tool_names": [
"string"
],
"total_turn_latency_ms": 0,
"updated_at": "2019-08-24T14:15:22Z",
"user_id": "string"
}
],
"has_more": true,
"next_cursor": "string",
"object": "list"
}{
"message": "limit must be an integer between 1 and 100.",
"name": "bad_request"
}{
"message": "The supplied API key is invalid or revoked.",
"name": "unauthorized"
}{
"message": "This API key does not have the required runs:read permission.",
"name": "insufficient_scope"
}{
"message": "Too many requests. Please try again later.",
"name": "rate_limited"
}{
"message": "Internal server error.",
"name": "internal_server_error"
}{
"message": "The API is temporarily unavailable.",
"name": "service_unavailable"
}