Prompts

A prompt is reusable message text you can attach to a model or apply globally. Reads are scoped by workspace_id. Reads need prompts:read and writes need prompts:write.

List prompts

GET /api/v1/prompts?workspace_id=ws_1

string

Limit results to one workspace.

string

Match prompts whose name contains this value.

string

SYSTEM, USER, or ASSISTANT.

string

PRODUCTION, STAGING, EVALUATION, or EXPERIMENTS.

curl 'https://app.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",
      "model": null
    }
  ],
  "total": 1
}

object

The model the prompt is attached to, as { id, name, display_name }, or null when the prompt is global.

Get a prompt

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

Create a prompt

POST /api/v1/prompts

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

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}

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

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

Delete a prompt

DELETE /api/v1/prompts/{id}

Get started

Setup

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