API reference

Threads

List, read, rename, and archive conversations, and reach their messages and files.

A thread is one conversation, pinned to the model that answered it.

List

GET /api/threads

Returns your threads with their titles, models, and timestamps.

Read

GET /api/threads/{id}/messages

Returns the full message history: questions, answers, tool calls, and the charts each turn produced.

Rename and archive

PATCH  /api/threads/{id}
DELETE /api/threads/{id}

Archiving removes a thread from the default list without destroying it. A thread you have shared publicly keeps its link working until you revoke the share.

Files

GET /api/threads/{id}/files

Files attached to a thread. A file uploaded into one conversation stays available in your library for reuse. See CSV and Excel.

On this page