Threads

A thread is a conversation within a sandbox. Each thread has its own message history, status, and cost tracking.

List Threads

GEThttps://relay.an.dev/v1/sandboxes/:id/threads

Returns all threads within a sandbox.

Path Parameters

Name	Type	Required	Description
id	string	Required	Sandbox ID

Response

[
  {
    "id": "th_xyz789",
    "name": "Chat 1",
    "status": "completed",
    "createdAt": "2026-02-26T12:00:00Z",
    "updatedAt": "2026-02-26T12:05:00Z"
  }
]

cURL

curl https://relay.an.dev/v1/sandboxes/sb_abc123/threads \
  -H "Authorization: Bearer YOUR_API_KEY"

Create Thread

POSThttps://relay.an.dev/v1/sandboxes/:id/threads

Creates a new conversation thread in a sandbox.

Path Parameters

Name	Type	Required	Description
id	string	Required	Sandbox ID

Request Body

Name	Type	Required	Description
name	string	Optional	Display name for the thread

Request Body

{
  "name": "Chat 1"
}

Response

{
  "id": "th_xyz789",
  "name": "Chat 1",
  "status": "active",
  "createdAt": "2026-02-26T12:00:00Z"
}

cURL

curl -X POST https://relay.an.dev/v1/sandboxes/sb_abc123/threads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Chat 1" }'

Get Thread

GEThttps://relay.an.dev/v1/sandboxes/:id/threads/:threadId

Retrieves a thread with its full message history.

Path Parameters

Name	Type	Required	Description
id	string	Required	Sandbox ID
threadId	string	Required	Thread ID

Response

{
  "id": "th_xyz789",
  "name": "Chat 1",
  "status": "completed",
  "messages": [
    { "role": "user", "content": "Hello" },
    { "role": "assistant", "content": "Hi there!" }
  ],
  "createdAt": "2026-02-26T12:00:00Z",
  "updatedAt": "2026-02-26T12:05:00Z"
}

Delete Thread

DELETEhttps://relay.an.dev/v1/sandboxes/:id/threads/:threadId

Deletes a thread and its message history.

Path Parameters

Name	Type	Required	Description
id	string	Required	Sandbox ID
threadId	string	Required	Thread ID

Returns 204 No Content on success.