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

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized
- `429` — Quota exceeded
- `500` — Internal server error

## Changes

- **2026-04-07** `b5edd97adf4a` — 2 info
  - api tag `Ingest` added
  - api tag `Conversations` removed
- **2026-03-15** `b40318167017` — 1 breaking
  - request body became required
- **2026-02-19** `8773015c1da0` — 2 info
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`

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

---

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