Logs
AGH Logs HTTP endpoints.
- Audience
- Operators running durable agent work
- Focus
- API Reference guidance shaped for scanability, day-two clarity, and operator context.
GET
/api/logsQuery Parameters
workspace_id?string
Workspace id
session_id?string
Session id
agent_name?string
Agent name
type?string
Event type
run?string
Task run id
actor?string
Actor as kind:id
actor_kind?string
Actor kind
actor_id?string
Actor id
provider?string
Provider id projected at event write time
outcome?string
Event registry outcome
component?string
Event registry component
error_only?boolean
Return warning and failure outcomes only
after_seq?integer
Return rows after this event summary sequence
Format
int32since?string
Only logs emitted since this timestamp
Format
date-timelimit?integer
Maximum number of records to return
Format
int32Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/logs"{
"events": [
{
"actor_id": "string",
"actor_kind": "string",
"agent_name": "string",
"claim_token_hash": "string",
"component": "string",
"content": null,
"coordinator_session_id": "string",
"hook_event": "string",
"hook_name": "string",
"id": "string",
"lease_until": "2019-08-24T14:15:22Z",
"outcome": "string",
"parent_session_id": "string",
"provider": "string",
"release_reason": "string",
"root_session_id": "string",
"run_id": "string",
"scheduler_reason": "string",
"session_id": "string",
"spawn_depth": 0,
"summary": "string",
"task_id": "string",
"timestamp": "2019-08-24T14:15:22Z",
"type": "string",
"workflow_id": "string",
"workspace_id": "string"
}
]
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}Empty
GET
/api/logs/streamQuery Parameters
workspace_id?string
Workspace id
session_id?string
Session id
agent_name?string
Agent name
type?string
Event type
run?string
Task run id
actor?string
Actor as kind:id
actor_kind?string
Actor kind
actor_id?string
Actor id
provider?string
Provider id projected at event write time
outcome?string
Event registry outcome
component?string
Event registry component
error_only?boolean
Return warning and failure outcomes only
after_seq?integer
Return rows after this event summary sequence
Format
int32since?string
Only logs emitted since this timestamp
Format
date-timelimit?integer
Maximum number of records to return
Format
int32Response Body
text/event-stream
application/json
application/json
curl -X GET "https://example.com/api/logs/stream"{
"actor_id": "string",
"actor_kind": "string",
"agent_name": "string",
"claim_token_hash": "string",
"component": "string",
"content": null,
"coordinator_session_id": "string",
"hook_event": "string",
"hook_name": "string",
"id": "string",
"lease_until": "2019-08-24T14:15:22Z",
"outcome": "string",
"parent_session_id": "string",
"provider": "string",
"release_reason": "string",
"root_session_id": "string",
"run_id": "string",
"scheduler_reason": "string",
"session_id": "string",
"spawn_depth": 0,
"summary": "string",
"task_id": "string",
"timestamp": "2019-08-24T14:15:22Z",
"type": "string",
"workflow_id": "string",
"workspace_id": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}{
"diagnostic": {
"category": "string",
"code": "string",
"data_freshness": "string",
"doc_url": "string",
"evidence": {
"property1": null,
"property2": null
},
"id": "string",
"message": "string",
"severity": "string",
"suggested_command": "string",
"title": "string"
},
"error": "string"
}Empty