Update a conversation | Runtype Documentation

curl -X PUT https://api.runtype.com/v1/conversations/id \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "messages": [
    {
      "content": "Help me write a function",
      "id": "msg_1",
      "role": "user"
    },
    {
      "content": "Sure! What kind of function would you like?",
      "id": "msg_2",
      "role": "assistant"
    }
  ],
  "metadata": {
    "topic": "programming"
  },
  "modelId": "claude-sonnet-4-5",
  "systemPrompt": "You are a coding assistant.",
  "title": "Updated Chat Title"
}'

{
  "createdAt": "string",
  "id": "string",
  "messages": [
    {}
  ],
  "metadata": {},
  "modelId": "string",
  "ownerId": "string",
  "source": "app",
  "systemPrompt": "string",
  "title": "string",
  "updatedAt": "string",
  "schemaWarnings": [
    {
      "code": "string",
      "field": "string",
      "message": "string"
    }
  ]
}

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Request

This endpoint expects an object.

messageslist of objectsOptional

metadatamap from strings to anyOptional

modelIdstringOptional<=255 characters

ownerIdstringOptional1-255 characters

systemPromptstringOptional

titlestringOptional<=500 characters

Response

Conversation updated

createdAtstring

idstring

messageslist of maps from strings to any

metadatamap from strings to any

modelIdstring or null

ownerIdstring or null

sourceenum

systemPromptstring or null

titlestring

updatedAtstring

schemaWarningslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error