---
title: "Ingest or update conversation"
method: POST
path: "/v4/conversations"
tags: ["Ingest"]
---

# Ingest or update conversation

`POST /v4/conversations`

Ingest or update a conversation

## Request body

- object
  - `conversationId` string, required
  - `messages` object[], required
    - `role` 'user' | 'assistant' | 'system' | 'tool', required
    - `content` union, required
      - string
      - union[]
        - union
          - object
            - `type` 'text', required
            - `text` string, required
          - object
            - `type` 'image_url', required
            - `imageUrl` object, required
              - …
    - `name` string
    - `tool_calls` unknown[]
      - unknown
    - `tool_call_id` string
  - `containerTags` string[]
  - `metadata` object

## Response `200`

Conversation ingested/updated successfully

- object
  - `id` string, required — ID of the document backing this conversation
  - `conversationId` string, required — The conversation ID supplied in the request
  - `status` string, required — Processing status of the document

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized
- `402` — Quota exceeded
- `409` — A container tag merge is in progress
- `500` — Internal server error

## Changes

- **2026-08-15** `b8c2dbc8f2b5` — 6 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `402`
  - …2 more

[Change history](https://skmtc.dev/supermemory/apis/supermemory-api/changes/v4/conversations/post.md)

---

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