Get conversation with messages | Runtype Documentation

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

{
  "id": "c3f1a9e2-7b4d-4f8a-9d2e-1a2b3c4d5e6f",
  "title": "Project Kickoff Discussion",
  "modelId": "gpt-4-turbo",
  "systemPrompt": "You are a helpful assistant for project management discussions.",
  "ownerId": "user_7890",
  "metadata": {
    "project": "Runtype API Integration",
    "priority": "high"
  },
  "messages": [
    {
      "id": "msg_001",
      "role": "user",
      "content": "Can you help me outline the project requirements?",
      "timestamp": "2024-06-01T09:15:00Z"
    },
    {
      "id": "msg_002",
      "role": "assistant",
      "content": "Sure! Let's start with the main objectives and deliverables.",
      "timestamp": "2024-06-01T09:16:00Z"
    }
  ],
  "source": "app",
  "createdAt": "2024-06-01T09:00:00Z",
  "updatedAt": "2024-06-01T09:16:00Z"
}

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Response

Conversation detail

idstring

titlestring

modelIdstring or null

systemPromptstring or null

ownerIdstring or null

metadatamap from strings to any

messageslist of maps from strings to any

sourceenum

Allowed values:

createdAtstring

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: Bearer <token>" \
>	-H "Content-Type: application/json"

1	{
2	"id": "c3f1a9e2-7b4d-4f8a-9d2e-1a2b3c4d5e6f",
3	"title": "Project Kickoff Discussion",
4	"modelId": "gpt-4-turbo",
5	"systemPrompt": "You are a helpful assistant for project management discussions.",
6	"ownerId": "user_7890",
7	"metadata": {
8	"project": "Runtype API Integration",
9	"priority": "high"
10	},
11	"messages": [
12	{
13	"id": "msg_001",
14	"role": "user",
15	"content": "Can you help me outline the project requirements?",
16	"timestamp": "2024-06-01T09:15:00Z"
17	},
18	{
19	"id": "msg_002",
20	"role": "assistant",
21	"content": "Sure! Let's start with the main objectives and deliverables.",
22	"timestamp": "2024-06-01T09:16:00Z"
23	}
24	],
25	"source": "app",
26	"createdAt": "2024-06-01T09:00:00Z",
27	"updatedAt": "2024-06-01T09:16:00Z"
28	}