---
title: "Put Agent Prompt Blocks"
method: PUT
path: "/api/v1/agents/{agent_id}/prompt-blocks"
tags: ["Prompt Blocks"]
---

# Put Agent Prompt Blocks

`PUT /api/v1/agents/{agent_id}/prompt-blocks`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/v1/agents/{agent_id}/prompt-blocks`
- Auth: none declared

Replace the agent's prompt-block overrides. Send the complete desired set; blocks not listed revert to the workspace default.

## Path parameters

- `agent_id` integer, required

## Request body

- PromptBlocksPut: The complete set of prompt-block overrides for this agent. Replacement is per block: a block you omit is removed; inside a block, fields you omit keep their stored value. To remove an override, omit its key; null is accepted only for an override that is already stored.
  - `prompt_blocks` object, required: {block_id: {enabled, text, order, hidden_rows}}. Omit a key to remove its override; null only for one already stored. Read GET /api/v1/prompt-blocks for valid ids.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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