For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETList conversations
      • POSTCreate a conversation
      • GETGet conversation with messages
      • PUTUpdate a conversation
      • DELDelete a conversation
Dashboard
LogoLogo
Runtype APIConversations

List conversations

GET
/v1/conversations
GET
/v1/conversations
$curl https://api.runtype.com/v1/conversations \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1{
2  "conversations": [
3    {
4      "id": "c9f1a2b4-3d7e-4f8a-9b2e-1a2b3c4d5e6f",
5      "title": "Q2 Product Launch Planning",
6      "modelId": "gpt-4-turbo",
7      "ownerId": "user_7890abcd1234",
8      "messageCount": 42,
9      "source": "app",
10      "createdAt": "2024-05-10T09:15:00Z",
11      "updatedAt": "2024-05-15T16:45:00Z"
12    }
13  ],
14  "pagination": {
15    "limit": 10,
16    "hasMore": true,
17    "nextCursor": "eyJpZCI6IjY3ODlhYmNkZWYxMjM0NTY3OCJ9"
18  }
19}
Was this page helpful?
Previous

Create a conversation

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Query parameters

sourceenumOptional
Allowed values:
surface_idstringOptional
client_token_idstringOptional
ownerIdstringOptional
limitintegerOptional>=1
cursorstringOptional

Response

Conversations list
conversationslist of objects
paginationobject

Errors

401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error