Create a conversation | Runtype Documentation

AuthorizationBearer

API key or Clerk session token

This endpoint expects an object.

metadatamap from strings to anyOptionalDefaults to {}

modelIdstringOptional<=255 characters

ownerIdstringOptional1-255 characters

systemPromptstringOptional

titlestringOptional<=500 charactersDefaults to New Chat

Conversation created

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

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/conversations \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"metadata": {
>	"topic": "general"
>	},
>	"modelId": "gpt-4",
>	"systemPrompt": "You are a helpful assistant.",
>	"title": "New Chat"
>	}'

$	curl -X POST https://api.runtype.com/v1/conversations \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"metadata": {
>	"topic": "general"
>	},
>	"modelId": "gpt-4",
>	"systemPrompt": "You are a helpful assistant.",
>	"title": "New Chat"
>	}'