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

# 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

---

[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/933e00a5599b/schema)