Get conversation with messages | Runtype Documentation

{
  "createdAt": "string",
  "id": "string",
  "messages": [
    {
      "content": "string",
      "role": "system",
      "author": {
        "type": "end_user",
        "externalId": "string",
        "id": "string",
        "name": "string"
      },
      "createdAt": "string",
      "id": "string",
      "metadata": {},
      "model": "string",
      "toolCalls": [
        {
          "toolCallId": "string",
          "toolName": "string",
          "args": {},
          "providerOptions": {}
        }
      ],
      "toolResults": [
        {
          "toolCallId": "string",
          "toolName": "string",
          "providerOptions": {},
          "result": null
        }
      ]
    }
  ],
  "metadata": {},
  "modelId": "string",
  "ownerId": "string",
  "source": "app",
  "systemPrompt": "string",
  "title": "string",
  "updatedAt": "string",
  "imported": true,
  "schemaWarnings": [
    {
      "code": "string",
      "field": "string",
      "message": "string"
    }
  ]
}

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Response

Conversation detail

createdAtstring

idstring

messageslist of objects

metadatamap from strings to any

modelIdstring or null

ownerIdstring or null

sourceenum

Allowed values:

systemPromptstring or null

titlestring

updatedAtstring

importedbooleanOptional

Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200).

schemaWarningslist of objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error