---
title: "Patch Prompt"
method: PATCH
path: "/admin/api/v1/prompts/{prompt_row_id}"
tags: ["Agent Configuration"]
---

# Patch Prompt

`PATCH /admin/api/v1/prompts/{prompt_row_id}`

Update tags on an existing prompt version.

Content changes are not accepted; clients POST a new version
instead. Empty body is a no op (no DB write, no reload).

## Path parameters

- `prompt_row_id` string, uuid, required

## Request body

- StandalonePromptPatch — Body for PATCH /admin/api/v1/prompts/{id}. Only ``tags`` is patchable. Sending null on ``tags`` is rejected (clearing tags means an empty list, not null). Content changes are not accepted on PATCH — clients POST a new version instead.
  - `tags` string[], nullable

## Response `200`

Successful Response

- StandaloneMutationResponseStandalonePromptRead
  - `data` StandalonePromptRead, required — GET response and the data payload of POST/PATCH/DELETE responses.
    - `id` string, uuid, required
    - `promptId` string, required
    - `version` integer, required
    - `content` string, required
    - `tags` string[], required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `reload` StandaloneReloadResult, required — Reload outcome attached to every admin mutation response. ``reloaded`` means DB committed and runtime now uses the new config. ``restart_required`` means DB committed and process restart is needed. ``reload_failed`` means DB rolled back and runtime is unchanged.
    - `status` 'reloaded' | 'restart_required' | 'reload_failed', required — Outcome of a reload triggered by an admin mutation.
    - `message` string, required
    - `error` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/idun-group/apis/idun-agent-engine-server.md) · [All operations](https://skmtc.net/idun-group/apis/idun-agent-engine-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/idun-group/idun-agent-engine-server/versions/8909cd73cc1c/schema)