Process log API
Tail workspace process logs for apps, runners, builds, and executions.
GET /v1/workspaces/{workspace_id}/logsBacked by Loki when available in the cell. Empty results are normal if logging is not configured.
See also: Process Log
Query parameters
| Param | Default | Purpose |
|---|---|---|
app_id | — | Filter by app |
runner_id | — | A coderunner ID (resolved to its current deployment) or a deployment ID |
deployment_id | — | A deployment ID, queried directly. Takes precedence over runner_id |
build_number | — | Filter by build (up to 200 characters) |
execution_id | — | Filter by execution (up to 200 characters) |
search | — | Free-text search (up to 200 characters) |
since_seconds | 900 | Lookback window in seconds, 10 to 604,800 (7 days) |
limit | 200 | Max entries, 1 to 1000 |
Values outside these ranges return 422. The response is { "entries": [{ "ts", "line", "labels" }], "has_more": false }.
If runner_id is a coderunner ID that isn't in this workspace, or the coderunner has no current deployment, the call returns 404 rather than an empty page. Other Loki errors return 502.
Permission: read
curl -s -H "Authorization: Bearer $TOKEN" \
"https://platform.groundfloor.cloud/v1/workspaces/$WORKSPACE_ID/logs?since_seconds=3600&limit=100" | jq .Related
- Coderunners API — job logs via
…/coderunners/{id}/logs/{job_id} - Audit API — control-plane activity, not runtime stdout