Skip to main content
GET
/
agents
/
instances
/
{instance_id}
/
logs
List Instance Logs
curl --request GET \
  --url https://api.example.com/agents/instances/{instance_id}/logs
[
  {
    "organization_id": "<string>",
    "agent_resource_id": "<string>",
    "log_type": "trigger_fired",
    "message": "<string>",
    "id": "<string>",
    "instance_id": "<string>",
    "metadata": {},
    "timestamp": "2023-11-07T05:31:56Z",
    "expires_at": "2023-11-07T05:31:56Z"
  }
]

Path Parameters

​
instance_id
string
required

Query Parameters

​
log_type
enum<string> | null

Filter by log type (e.g., tool_call, reasoning, agent_error) Types of agent log entries.

Available options:
trigger_fired,
agent_started,
agent_completed,
agent_error,
tool_call,
tool_result,
reasoning,
decision,
plan_created,
plan_updated,
step_started,
step_completed
​
limit
integer
default:100

Maximum entries to return.

Required range: 1 <= x <= 500

Response

Successful Response

​
organization_id
string
required
​
agent_resource_id
string
required
​
log_type
enum<string>
required

Types of agent log entries.

Available options:
trigger_fired,
agent_started,
agent_completed,
agent_error,
tool_call,
tool_result,
reasoning,
decision,
plan_created,
plan_updated,
step_started,
step_completed
​
message
string
required
​
id
string | null
​
instance_id
string | null
​
metadata
Metadata · object
​
timestamp
string<date-time>
​
expires_at
string<date-time>