Workspaces

A workspace groups providers, models, prompts, mappings, configs, and indexes. Reads need workspaces:read and writes need workspaces:write. Member and budget actions have their own scopes and roles, noted below.

List workspaces

GET /api/v1/workspaces

Each row carries my_role and a stats summary.

curl 'https://platform.nemu.cc/api/v1/workspaces' \
  -H 'Authorization: Bearer <access_token>'

const workspaces = await nemu.workspaces.list();

{
  "data": [
    {
      "id": "ws_1",
      "name": "prod",
      "owner_id": "3f0e...",
      "my_role": "OWNER",
      "stats": {
        "member_count": 3,
        "prompt_count": 12,
        "config_count": 2,
        "mapping_count": 4,
        "provider_count": 2
      },
      "created_at": "2026-01-04T10:22:00.000Z",
      "updated_at": "2026-02-01T09:00:00.000Z"
    }
  ],
  "total": 1
}

Get a workspace

GET /api/v1/workspaces/{id}

Create a workspace

POST /api/v1/workspaces

string

required

A name for the workspace, from 1 to 128 characters.

curl -X POST 'https://platform.nemu.cc/api/v1/workspaces' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{"name": "prod"}'

const workspace = await nemu.workspaces.create({ name: "prod" });

Update a workspace

PATCH /api/v1/workspaces/{id}

string

A new name for the workspace.

SDK

await workspace.update({ name: "production" });

Delete a workspace

DELETE /api/v1/workspaces/{id}

Only the owner can delete a workspace.

SDK

await workspace.delete();

Members

Reads need members:read and writes need members:write.

List members

GET /api/v1/workspaces/{id}/members

{
  "data": [
    {
      "id": "mem_1",
      "workspace_id": "ws_1",
      "user_id": "3f0e...",
      "role": "OWNER",
      "created_at": "2026-01-04T10:22:00.000Z",
      "user": {
        "id": "3f0e...",
        "username": "user",
        "email": "user@example.com"
      }
    }
  ]
}

Invite a member

POST /api/v1/workspaces/{id}/members

Creates an invitation and returns a shareable link.

string[]

Limit the invite to specific email addresses.

integer

How many times the invite can be redeemed.

integer

How many days the invite stays valid.

{
  "data": {
    "id": "inv_1",
    "code": "abc123",
    "link": "https://platform.nemu.cc/invite/abc123",
    "expires_at": "2026-02-10T00:00:00.000Z",
    "max_uses": 5
  }
}

Update a member role

PATCH /api/v1/workspaces/{id}/members/{member_id}

string

required

ADMIN or MEMBER.

Remove a member

DELETE /api/v1/workspaces/{id}/members/{member_id}

Budget

The monthly spend cap for a workspace. Reading needs workspace membership. Updating needs an administrator role on the workspace.

Get the budget

GET /api/v1/workspaces/{id}/budget

{
  "budget": 100,
  "current_spend": 42.5,
  "remaining": 57.5
}

Update the budget

PATCH /api/v1/workspaces/{id}/budget

number

required

The monthly cap, from 0 to 1000000.

{
  "success": true,
  "budget": 250
}

Gateway token

Mints a short lived gateway key so a workspace can send inference through the gateway. This endpoint authenticates with your app credentials rather than a bearer token, so reach for the SDK, which handles it for you.

POST /api/v1/workspaces/{id}/gate-token

SDK

const key = await workspace.gateway_key();

{
  "gate_key": "eyJhbGciOi..."
}

Get started

API reference

List workspaces

Get a workspace

Create a workspace

Update a workspace

Delete a workspace

Members

List members

Invite a member

Update a member role

Remove a member

Budget

Get the budget

Update the budget

Gateway token

​List workspaces

​Get a workspace

​Create a workspace

​Update a workspace

​Delete a workspace

​Members

​List members

​Invite a member

​Update a member role

​Remove a member

​Budget

​Get the budget

​Update the budget

​Gateway token

List workspaces

Get a workspace

Create a workspace

Update a workspace

Delete a workspace

Members

List members

Invite a member

Update a member role

Remove a member

Budget

Get the budget

Update the budget

Gateway token