> ## 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 Workspace - POST /v1/workspaces

> Create an isolated tenant via POST /v1/workspaces; the creator becomes owner automatically. Optional name.

Create a workspace (an isolated tenant). The caller automatically becomes its `owner` and a membership row is written. Knowledge bases, memory, wiki, etc. all live under a workspace.

## Endpoint

```http theme={null}
POST /v1/workspaces
```

## Authentication

`Authorization: Bearer <jwt>` or `X-API-Key <sk_...>` (auth only, no workspace role required).

## Request body

**name** `string`

Workspace name; defaults to "新工作空间" when omitted.

## Response

**id** `string`

Workspace id (`ws_...`).

**name** `string`

Name.

**role** `string`

The creator's role in the workspace, always `owner`.

## Example

```bash cURL theme={null}
curl -X POST https://memo.ariacompute.com/v1/workspaces \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Research Team"}'
```

```json 200 theme={null}
{
  "id": "ws_01a2b3c4d5e6",
  "name": "My Research Team",
  "role": "owner"
}
```


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