Create a conversation | Runtype Documentation

AuthorizationBearer

API key or Clerk session token

This endpoint expects an object.

titlestringOptional<=500 charactersDefaults to New Chat

modelIdstringOptional<=255 characters

systemPromptstringOptional

ownerIdstringOptional1-255 characters

metadatamap from strings to anyOptionalDefaults to {}

Conversation created

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

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

1	{
2	"id": "c3f1a9e2-7b4d-4f3a-9d2e-8a1b2c3d4e5f",
3	"title": "Project Kickoff Discussion",
4	"modelId": "gpt-4-turbo",
5	"systemPrompt": "You are a helpful assistant for project management discussions.",
6	"ownerId": "user_987654321",
7	"metadata": {},
8	"messages": [
9	{}
10	],
11	"source": "app",
12	"createdAt": "2024-06-01T09:15:00Z",
13	"updatedAt": "2024-06-01T09:15:00Z"
14	}

$	curl -X POST https://api.runtype.com/v1/conversations \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"id": "c3f1a9e2-7b4d-4f3a-9d2e-8a1b2c3d4e5f",
3	"title": "Project Kickoff Discussion",
4	"modelId": "gpt-4-turbo",
5	"systemPrompt": "You are a helpful assistant for project management discussions.",
6	"ownerId": "user_987654321",
7	"metadata": {},
8	"messages": [
9	{}
10	],
11	"source": "app",
12	"createdAt": "2024-06-01T09:15:00Z",
13	"updatedAt": "2024-06-01T09:15:00Z"
14	}