---
title: "Ingest content into memory system (async embedding)"
method: POST
path: "/api/memory/index"
tags: ["Memory"]
---

# Ingest content into memory system (async embedding)

`POST /api/memory/index`

## Request body

- object
  - `agentId` string
  - `content` string, required
  - `name` string, required
  - `scope` 'agent' | 'swarm', required
  - `source` 'manual' | 'file_index' | 'session_summary' | 'task_completion', required
  - `sourceTaskId` string, uuid
  - `sourcePath` string
  - `tags` string[]
  - `persistMemory` boolean
  - `contextKey` string

## Response `202`

Content queued for embedding

## Other responses

- `400` — Validation error

## Changes

- **2026-07-28** `cf533d6b49b0` — 1 info
  - the `agentId` request property format was generalized from `uuid` to no format

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/memory/index/post.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/revisions/92a1dcbd2fc7/schema)