Prompts

A prompt is reusable message text you can attach to a model or apply globally. Prompts belong to a workspace, so pass workspace_id on reads and writes. Reads need prompts:read and writes need prompts:write.

List prompts

GET /api/v1/prompts?workspace_id=ws_1

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

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

{
  "data": [
    {
      "id": "prm_1",
      "workspace_id": "ws_1",
      "model_id": null,
      "name": "support tone",
      "content": "You are a calm support agent.",
      "type": "SYSTEM",
      "is_global": true,
      "enabled": true,
      "position": 0,
      "environment": "PRODUCTION",
      "created_at": "2026-01-04T10:22:00.000Z",
      "updated_at": "2026-01-04T10:22:00.000Z"
    }
  ]
}

Get a prompt

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

Create a prompt

POST /api/v1/prompts

string

required

The workspace the prompt belongs to.

string

required

A name for the prompt.

string

required

The prompt text.

string

One of SYSTEM, USER, or ASSISTANT.

string | null

Attach the prompt to a specific model, or leave it null.

boolean

Apply the prompt across the workspace.

boolean

Whether the prompt is active.

integer

The order the prompt is applied in.

string | null

One of PRODUCTION, STAGING, EVALUATION, EXPERIMENTS, or null.

const prompt = await workspace.prompts.create({
  name: "support tone",
  content: "You are a calm support agent.",
  type: "SYSTEM",
  is_global: true,
});

Update a prompt

PATCH /api/v1/prompts/{id}

Accepts any create field. Send workspace_id in the body.

Delete a prompt

DELETE /api/v1/prompts/{id}

Get started

API reference

List prompts

Get a prompt

Create a prompt

Update a prompt

Delete a prompt

​List prompts

​Get a prompt

​Create a prompt

​Update a prompt

​Delete a prompt

List prompts

Get a prompt

Create a prompt

Update a prompt

Delete a prompt