---
title: "Create a conversation"
method: POST
path: "/v1/conversations"
tags: ["conversations"]
---

# Create a conversation

`POST /v1/conversations`

## Request body

- CoreConversationCreateRequest
  - `items` object[]
  - `metadata` object

## Response `200`

OK

- CoreConversation
  - `created_at` integer
  - `id` string
  - `metadata` object
  - `object` string — "conversation"

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2026-08-22** `496ff50bdfef` — 3 info
  - added the optional property `error/provider` to the response with the `400` status
  - added the optional property `error/provider` to the response with the `401` status
  - added the optional property `error/provider` to the response with the `500` status
- **2026-06-08** `8c7901df38df` — 1 breaking
  - the `items/items/` request property type/format changed from `array`/`` to `object`/``
- **2026-05-29** `29b33b30e62e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/v1/conversations/post.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) · [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/enterpilot/gomodel-api/revisions/496ff50bdfef/schema)