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

# Create Memory Cube - POST /v1/workspaces/:workspace_id/cubes

> Create a memory cube via POST /v1/workspaces/:workspace_id/cubes; optional name, readable, writable. Minimum role contributor.

Create a memory cube — the isolation unit of memory. A cube can carry readable/writable principal lists for fine-grained access control.

## Endpoint

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

## Authentication

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

## Path parameters

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

Workspace id.

## Request body

**name** `string`

Cube name; defaults to "默认记忆立方体" when omitted.

**readable** `string[]`

List of readable principal ids.

**writable** `string[]`

List of writable principal ids.

## Response

**id** `string`

Cube id (`cube_...`).

**name** `string`

Name.

**owner\_id** `string`

Owner user id.

**workspace\_id** `string`

Owning workspace id.

**readable** `string[]`

Readable principal ids.

**writable** `string[]`

Writable principal ids.

**created\_at** `string`

Creation time (RFC3339).

## Example

```bash cURL theme={null}
curl -X POST https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/cubes \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"name":"User Profile","readable":["usr_aa"],"writable":["usr_aa"]}'
```

```json 200 theme={null}
{
  "id": "cube_01a2b3c4d5e6",
  "name": "User Profile",
  "owner_id": "usr_01a2b3c4d5e6",
  "workspace_id": "ws_01a2b3c4d5e6",
  "readable": ["usr_aa"],
  "writable": ["usr_aa"],
  "created_at": "2026-10-12T08:20:00Z"
}
```


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