Providers

A provider is an upstream endpoint that serves models. Providers belong to a workspace, so pass workspace_id on reads and writes. Reads need providers:read and writes need providers:write.

List providers

GET /api/v1/providers?workspace_id=ws_1

curl 'https://platform.nemu.cc/api/v1/providers?workspace_id=ws_1' \
  -H 'Authorization: Bearer <access_token>'

const providers = await workspace.providers.list();

{
  "data": [
    {
      "id": "prov_1",
      "user_id": "3f0e...",
      "workspace_id": "ws_1",
      "name": "primary",
      "base_url": "https://api.upstream.com/v1",
      "priority": 1,
      "api_key": null,
      "compatibility": "OPENAI_SDK",
      "model_options": [],
      "created_at": "2026-01-04T10:22:00.000Z",
      "updated_at": "2026-01-04T10:22:00.000Z"
    }
  ]
}

The api_key is write only. It is accepted on create and update, and never returned.

Get a provider

GET /api/v1/providers/{id}?workspace_id=ws_1

Create a provider

POST /api/v1/providers

string

required

The workspace the provider belongs to.

string

required

A name for the provider.

string

required

The upstream base URL.

integer

required

The order in which providers are tried. Lower runs first.

string

required

One of OPENAI_SDK, CEREBRAS, NVIDIA_NIM, or DEEPSEEK.

string

The upstream key. Stored encrypted and never returned.

string[]

Extra model identifiers to expose from this provider.

const provider = await workspace.providers.create({
  name: "primary",
  base_url: "https://api.upstream.com/v1",
  priority: 1,
  compatibility: "OPENAI_SDK",
  api_key: "sk_upstream_key",
});

Update a provider

PATCH /api/v1/providers/{id}

Accepts any create field. Send workspace_id in the body.

Delete a provider

DELETE /api/v1/providers/{id}

Get started

API reference

List providers

Get a provider

Create a provider

Update a provider

Delete a provider

​List providers

​Get a provider

​Create a provider

​Update a provider

​Delete a provider

List providers

Get a provider

Create a provider

Update a provider

Delete a provider