API Reference

REST API

Query the timeline, list events and restore files programmatically. Base URL: /v1

Authentication

Include your local API token in the Authorization header.

Authorization: Bearer recall_xxxxxxxx

GET /v1/events

List timeline events for a workspace, ordered newest first.

curl -H "Authorization: Bearer recall_xxx" \
  "http://localhost:5678/v1/events?workspace=my-app&limit=10"

{
  "events": [
    {
      "id": "evt_01",
      "time": "09:42",
      "type": "checkpoint",
      "agent": "Claude Code",
      "file": "src/login.ts",
      "action": "created"
    }
  ]
}

POST /v1/restore

Restore a file, folder or full workspace state.

curl -X POST -H "Authorization: Bearer recall_xxx" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"my-app","file":"src/login.ts","time":"09:42"}' \
  "http://localhost:5678/v1/restore"

GET /v1/timeline

Return the full timeline including branches and checkpoints.

Endpoints overview

Method	Path	Description
GET	/v1/events	List timeline events
GET	/v1/timeline	Full timeline with branches
POST	/v1/restore	Restore file, folder or state
GET	/v1/workspaces	List watched workspaces
GET	/v1/health	Service health check

Full interactive documentation is available in the Developer Guide and on GitHub.