Mappings

A mapping points an incoming model name at a target model, so callers can use a stable name while you change what runs behind it. Reads are scoped by workspace_id. Reads need mapping:read and writes need mapping:write.

List mappings

GET /api/v1/mappings?workspace_id=ws_1

string

Limit results to one workspace.

string

Match mappings whose source name contains this value.

string

Match mappings whose target model contains this value.

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

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

{
  "data": [
    {
      "id": "map_1",
      "workspace_id": "ws_1",
      "source_name": "gpt-4",
      "target_model": "primary/gpt-oss-120b",
      "priority": 1,
      "enabled": true,
      "is_pattern": false,
      "created_at": "2026-01-04T10:22:00.000Z",
      "updated_at": "2026-01-04T10:22:00.000Z"
    }
  ]
}

Get a mapping

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

Create a mapping

POST /api/v1/mappings

Creates land in your account’s default workspace. A workspace_id in the body is ignored.

string

required

The incoming name callers send.

string

required

The gateway name to route to.

integer

default:"0"

0 to 1000. The order in which mappings are matched. Lower runs first.

boolean

default:"true"

Whether the mapping is active.

boolean

default:"true"

Treat source_name as a pattern rather than an exact match. This defaults to true, so a mapping is a pattern unless you say otherwise.

const mapping = await workspace.mappings.create({
  source_name: "gpt-4",
  target_model: "primary/gpt-oss-120b",
});

Update a mapping

PATCH /api/v1/mappings/{id}

PATCH is a full replace, not a merge. It validates the same schema as create, so source_name and target_model are required on every update.

The response carries no body beyond { "success": true }. The SDK re-reads the mapping after a write.

Delete a mapping

DELETE /api/v1/mappings/{id}

Get started

Setup

API reference

List mappings

Get a mapping

Create a mapping

Update a mapping

Delete a mapping

​List mappings

​Get a mapping

​Create a mapping

​Update a mapping

​Delete a mapping

List mappings

Get a mapping

Create a mapping

Update a mapping

Delete a mapping