Skip to main content
GET
/
v1
/
replica
/
{id}
/
read
Read Replica History
curl --request GET \
  --url https://api.replicas.dev/v1/replica/{id}/read \
  --header 'Authorization: Bearer <token>'
{
  "thread_id": "<string>",
  "events": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "type": "<string>",
      "payload": {}
    }
  ],
  "total": 123,
  "hasMore": true,
  "coding_agent": "claude",
  "waking": true
}

Authorizations

Authorization
string
header
required

API key authentication. Obtain your API key from the Replicas dashboard under Settings > API Keys.

Path Parameters

id
string<uuid>
required

The unique identifier of the replica

Query Parameters

limit
integer

Maximum number of events to return

Required range: x >= 1
offset
integer
default:0

Number of events to skip from the end

Required range: x >= 0

Response

Successful response

Response containing paginated conversation history

thread_id
string | null
required

Thread/session ID

events
object[]
required

History events (paginated from the end)

total
integer
required

Total number of events

hasMore
boolean
required

Whether there are more events available

coding_agent
enum<string> | null

Currently active coding agent

Available options:
claude,
codex
waking
boolean | null

Whether the workspace was just woken from sleep. Retry in 30-90 seconds.