Get conversation with messages | Runtype Documentation

curl https://api.runtype.com/v1/conversations/id \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json"

{
  "createdAt": "2024-06-10T09:15:00Z",
  "id": "c3f1a9e2-7b4d-4f8a-9d2e-1a2b3c4d5e6f",
  "messages": [
    {
      "id": "msg-001",
      "role": "user",
      "content": "Hello, can you help me with my project?",
      "timestamp": "2024-06-10T09:15:05Z"
    },
    {
      "id": "msg-002",
      "role": "assistant",
      "content": "Of course! What do you need assistance with?",
      "timestamp": "2024-06-10T09:15:10Z"
    }
  ],
  "metadata": {
    "project": "AI Chatbot Development",
    "priority": "high"
  },
  "modelId": "gpt-4-turbo",
  "ownerId": "user_7890",
  "source": "app",
  "systemPrompt": "You are a helpful assistant specialized in AI development.",
  "title": "Chat about AI project",
  "updatedAt": "2024-06-10T09:20:00Z"
}

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Response

Conversation detail

createdAtstring

idstring

messageslist of maps from strings to any

metadatamap from strings to any

modelIdstring or null

ownerIdstring or null

sourceenum

Allowed values:

systemPromptstring or null

titlestring

updatedAtstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/conversations/id \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"

1	{
2	"createdAt": "2024-06-10T09:15:00Z",
3	"id": "c3f1a9e2-7b4d-4f8a-9d2e-1a2b3c4d5e6f",
4	"messages": [
5	{
6	"id": "msg-001",
7	"role": "user",
8	"content": "Hello, can you help me with my project?",
9	"timestamp": "2024-06-10T09:15:05Z"
10	},
11	{
12	"id": "msg-002",
13	"role": "assistant",
14	"content": "Of course! What do you need assistance with?",
15	"timestamp": "2024-06-10T09:15:10Z"
16	}
17	],
18	"metadata": {
19	"project": "AI Chatbot Development",
20	"priority": "high"
21	},
22	"modelId": "gpt-4-turbo",
23	"ownerId": "user_7890",
24	"source": "app",
25	"systemPrompt": "You are a helpful assistant specialized in AI development.",
26	"title": "Chat about AI project",
27	"updatedAt": "2024-06-10T09:20:00Z"
28	}