Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Meza-dev/Ghostly/llms.txt

Use this file to discover all available pages before exploring further.

The GET /v1/runs endpoint returns an array of RunRecord objects for every run created by the authenticated user. Results are sorted by startedAt in descending order (most recent first). You can optionally scope the list to a single project by passing the project query parameter. Unlike GET /v1/runs/:id, the list response omits the events array from each record to keep payloads small. Fetch individual runs when you need full assist-event history.

​
Authentication

Pass an API key via the X-Api-Key header or a JWT via the Authorization: Bearer <token> header.

​
Query Parameters

​
project
string
Filter results to runs associated with this project slug. When omitted, runs from all projects are returned.

​
Response — 200 OK

An array of RunRecord objects. Each object contains the same top-level fields as GET /v1/runs/:id, but without the events array.
​
[]
RunRecord[]

​
Examples

curl https://api.ghostly.dev/v1/runs \
  -H "X-Api-Key: gly_YOUR_API_KEY"
To retrieve the full event log for an AI-assisted run (e.g. to replay or debug a healing sequence), call GET /v1/runs/:id for that specific run — the list endpoint intentionally omits events to keep bulk responses lightweight.

Build docs developers (and LLMs) love

Get started for freeTalk to us