---
title: "Replace node custom agent prompts"
method: PUT
path: "/api/v1/nodes/{nodeId}/agent-prompts"
tags: ["Nodes"]
---

# Replace node custom agent prompts

`PUT /api/v1/nodes/{nodeId}/agent-prompts`

## Request

- Base URL: `https://api-docs.busabase.com`
- URL: `https://api-docs.busabase.com/api/v1/nodes/{nodeId}/agent-prompts`
- Auth: none declared

## Path parameters

- `nodeId` string, required

## Request body

- object
  - `agentPrompts` object[], required
    - `key` string, required
    - `intent` 'read-only' | 'change'
    - `label` union, required: i18n string
      - string
      - object
    - `body` union, required: i18n string
      - string
      - object

## Response `200`

Replaced this node's custom scenario prompts — the whole custom list, not a merge. Send `null` to clear custom prompts; built-in prompts are always retained. These custom prompts are what `playbooks.search` finds for agents, and they are appended after the node type's built-in scenarios. Requires write access on the node.

- object
  - `nodeId` string, required
  - `agentPrompts` object[], required
    - `key` string, required
    - `intent` 'read-only' | 'change'
    - `label` union, required: i18n string
      - string
      - object
    - `body` union, required: i18n string
      - string
      - object

---

[API](https://skmtc.dev/busabase/apis/busabase-api.md) · [All operations](https://skmtc.dev/busabase/apis/busabase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/busabase/apis/busabase-api/revisions/bc6a7d5ff4c1?raw)