Providers

A provider is an upstream endpoint that serves models. Reads are scoped to a workspace, so pass workspace_id as a query parameter. Reads need providers:read and writes need providers:write.

Creates always land in your account’s default workspace. A workspace_id in the body is ignored. Only reads accept a workspace.

List providers

GET /api/v1/providers?workspace_id=ws_1

string

Limit results to one workspace.

string

Match providers whose name contains this value.

string

OPENAI_COMPATIBLE or ANTHROPIC.

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

const providers = await workspace.providers.list({ compatibility: "ANTHROPIC" });

{
  "data": [
    {
      "id": "prov_1",
      "user_id": "3f0e...",
      "workspace_id": "ws_1",
      "name": "primary",
      "enabled": true,
      "base_url": "https://api.upstream.com/v1",
      "user_agent": null,
      "priority": 1,
      "compatibility": "OPENAI_COMPATIBLE",
      "source": "custom",
      "models_dev_id": null,
      "has_api_key": true,
      "created_at": "2026-01-04T10:22:00.000Z",
      "updated_at": "2026-01-04T10:22:00.000Z"
    }
  ],
  "total": 1
}

boolean

Whether an upstream key is stored. The key itself is sealed and is never returned.

string

custom for a provider you configured by hand, or automatic for one resolved from the models catalog.

Get a provider

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

Create a provider

POST /api/v1/providers

string

required

4 to 32 characters, letters, numbers, hyphens, and underscores only. Stored lowercased.

integer

required

0 to 1000. The order in which providers are tried. Lower runs first.

string

default:"custom"

custom or automatic.

string

OPENAI_COMPATIBLE or ANTHROPIC. Required when source is custom.

string

The catalog identifier. Required when source is automatic. Max 128 characters.

string

The upstream base URL. An http or https URL, or an empty string.

string

The upstream key. Sealed on write and never returned.

string

Overrides the User-Agent sent upstream. Max 256 printable ASCII characters.

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

Update a provider

PATCH /api/v1/providers/{id}

PATCH is a full replace, not a merge. It validates the same schema as create, so name and priority are required on every update. Omitting a field clears it rather than keeping it.

The response carries no body beyond { "success": true }. The SDK re-reads the provider after a write so the entity you hold stays accurate.

await provider.update({
  name: provider.name,
  priority: 2,
  compatibility: "OPENAI_COMPATIBLE",
  base_url: provider.base_url ?? "",
});

Delete a provider

DELETE /api/v1/providers/{id}

Get started

Setup

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