---
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

---

[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)