Skip to main content
The Logs resource exposes your workspace’s runtime log stream. Entries cover inbound requests, capability calls, agent run output, and error traces. Three access patterns are available — paginated listing with time-range filters, full-text search with structured filters, and live tail. By the end of this page you will know which endpoint matches which question.

​
A log entry in shape

Use request_id to correlate entries across a single inbound request.

​
Endpoints

List entries with cursor pagination and time-range filters. Full-text query with structured filters. Stream new entries as they arrive.

​
Which one to call

​
Filter parameters

​
Tail protocol

GET /logs/tail streams entries with the same shape as /logs — one entry per event. Each carries ts, level, source, message, and request_id. 
curl -N "https://api.gavai.app/v1/workspaces/acme/logs/tail" \
  -H "Authorization: Bearer gak_live_xxxxxxxxxxxxx"

​
Common errors

Deployments

List deployments, inspect status, cancel in-flight builds, or promote to live.