---
title: "POST /falcon-ai/memory/"
method: POST
path: "/falcon-ai/memory/"
tags: ["falcon-ai"]
---

# POST /falcon-ai/memory/

`POST /falcon-ai/memory/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/falcon-ai/memory/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

List and create workspace memories.

## Request body

- FalconMemoryCreate
  - `key` string, required
  - `value` string, required

## Response `200`

OK

- FalconMemoryDetailResponse
  - `status` boolean, required
  - `result` FalconMemory, required
    - `id` string, uuid
    - `key` string, required
    - `value` string, required
    - `source` 'user' | 'agent' | 'init'
    - `created_at` string, date-time

## Other responses

- `201`: Created
- `403`: Forbidden
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)