> ## 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 Memory Node - POST /v1/workspaces/:workspace_id/cubes/:cube_id/nodes

> Write a memory node into a cube via POST /v1/workspaces/:workspace_id/cubes/:cube_id/nodes. Minimum role contributor.

Add a memory node to a cube. The node is vectorized for later semantic search and edge wiring.

## Endpoint

```http theme={null}
POST /v1/workspaces/:workspace_id/cubes/:cube_id/nodes
```

## Authentication

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

## Path parameters

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

Workspace id.

**cube\_id** `string` *required*

Cube id.

## Request body

**type** `string`

Node type (`text` / `tool_trace` / `persona` / `skill`); server default when omitted.

**content** `string` *required*

Node content text.

**tier** `integer`

Tier (1–4).

**source\_type** `string`

Source type (`document` / `chunk` / `session` / `wiki`).

**source\_id** `string`

Source object id.

## Response

**id** `string`

New node id (`node_...`).

## Example

```bash cURL theme={null}
curl -X POST https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/cubes/cube_01a2b3c4d5e6/nodes \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"type":"text","content":"User prefers Chinese replies.","tier":4,"source_type":"session","source_id":"sess_01a2b3c4d5e6"}'
```

```json 200 theme={null}
{
  "id": "node_01a2b3c4d5e6"
}
```


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