Skip to main content
GET
List workspace logs
List completed commands with captured output and related file operations, newest first. Use limit and after for pagination, or format=jsonl to export all matching commands. Log retention depends on the server.
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.

Authorizations

Authorization
string
header
required

The server's token (MIRAGE_AUTH_TOKEN) or a JWT. A daemon in the default local mode with no token accepts requests without one.

Path Parameters

workspace_id
string
required

Workspace ID.

Query Parameters

session
string

Filter by session ID. Omit or leave empty to include all sessions.

limit
integer
default:50

Maximum commands per JSON page. Ignored for JSONL export.

Required range: 1 <= x <= 200
after
string

The next cursor from the previous JSON page. Reuse it on the same server with the same filters. Results can change between pages. Ignored for JSONL export.

format
string
default:json

Use json for paginated results, newest first, or jsonl to export all retained matches oldest first. JSONL ignores limit and after and contains command, vfs, and result records linked by parent. Each record has a timestamp, an RFC 3339 string in UTC. Values other than jsonl select JSON.

Response

Completed command logs. Empty JSON returns {"items": [], "next": null}; an empty JSONL export has no body.

items
CommandLog · object[]
required
next
string | null
required

Cursor for the next page, or null when no more results are available.