> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Extract Chat Memory - POST /v1/workspaces/:workspace_id/chat-sessions/:session_id/extract

> Trigger async memory extraction from a session via POST /v1/workspaces/:workspace_id/chat-sessions/:session_id/extract. Minimum role contributor.

Trigger memory extraction for a session: distill durable facts / preferences / constraints / events into layered chat memory (L0–L3). The task runs **asynchronously**; the endpoint returns "accepted" immediately.

## Endpoint

```http theme={null}
POST /v1/workspaces/:workspace_id/chat-sessions/:session_id/extract
```

## Authentication

`Authorization: Bearer <jwt>` or `X-API-Key <sk_...>`. Minimum role: **contributor**.

## Path parameters

**workspace\_id** `string` *required*

Workspace id.

**session\_id** `string` *required*

Session id.

## Response

**accepted** `boolean`

Always true (task accepted, runs in background).

## Example

```bash cURL theme={null}
curl -X POST https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/chat-sessions/sess_01a2b3c4d5e6/extract \
  -H "Authorization: Bearer <jwt>"
```

```json 200 theme={null}
{
  "accepted": true
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.