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. Mappings belong to a workspace, so pass workspace_id on reads and writes. Reads need mapping:read and writes need mapping:write.

List mappings

GET /api/v1/mappings?workspace_id=ws_1

curl 'https://platform.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

string

required

The workspace the mapping belongs to.

string

required

The incoming name callers send.

string

required

The gateway name to route to.

integer

The order in which mappings are matched. Lower runs first.

boolean

Whether the mapping is active.

boolean

Treat source_name as a pattern rather than an exact match.

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

Update a mapping

PATCH /api/v1/mappings/{id}

Accepts any create field. Send workspace_id in the body.

Delete a mapping

DELETE /api/v1/mappings/{id}

Get started

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