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

# Add Message - POST /v1/workspaces/:workspace_id/chat-sessions/:session_id/messages

> Append a message to a session via POST /v1/workspaces/:workspace_id/chat-sessions/:session_id/messages. Minimum role contributor.

Append a message (user or assistant turn) to a chat session.

## Endpoint

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

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

## Request body

**role** `string`

Speaker role (`user` / `assistant` / `system`); defaults to `user`.

**content** `string` *required*

Message content.

## Response

**id** `string`

Message id (`msg_...`).

**session\_id** `string`

Owning session id.

**workspace\_id** `string`

Owning workspace id.

**role** `string`

Speaker role.

**content** `string`

Message content.

**seq** `integer`

Order index of the message within the session.

**created\_at** `string`

Creation time (RFC3339).

## Example

```bash cURL theme={null}
curl -X POST https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/chat-sessions/sess_01a2b3c4d5e6/messages \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"role":"user","content":"I want to learn about AriaMem pricing."}'
```

```json 200 theme={null}
{
  "id": "msg_01a2b3c4d5e6",
  "session_id": "sess_01a2b3c4d5e6",
  "workspace_id": "ws_01a2b3c4d5e6",
  "role": "user",
  "content": "I want to learn about AriaMem pricing.",
  "seq": 0,
  "created_at": "2026-10-12T09:01:00Z"
}
```


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