---
title: "Update a custom writing prompt"
method: PUT
path: "/prompts/{id}"
tags: ["Prompts"]
---

# Update a custom writing prompt

`PUT /prompts/{id}`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/prompts/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Path parameters

- `id` string, required: Prompt ID

## Request body

- UpdatePromptInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `category` string, required: Prompt category
  - `example` string, required: Full example post for the prompt
  - `text` string, required: Prompt text

## Response `200`

OK

- PromptResponse
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `category` string, required: Prompt category
  - `created_at` string, required: Creation time (ISO 8601)
  - `example` string, required: Full example post for the prompt (may be empty)
  - `id` string, required: Prompt ID
  - `is_built_in` boolean, required: Whether this is a built-in prompt
  - `text` string, required: Prompt text
  - `user_id` string: User ID (if custom)
  - `workspace_id` string: Workspace ID (if custom)

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

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