> ## Documentation Index
> Fetch the complete documentation index at: https://docs.promptbank.club/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Prompt — PATCH /api/v1/prompts/{promptId}

> Partially update a prompt with PATCH. Send only the fields you want to change — omitted fields stay untouched. Returns the full updated prompt object.

Partially update an existing prompt. You only need to include the fields you want to change — any fields you omit remain exactly as they are. This makes it easy to rename a prompt, adjust an aspect ratio, or swap out the model without having to re-send the entire object.

<Note>
  **PATCH** `https://www.promptbank.club/api/v1/prompts/{promptId}`
</Note>

## Path Parameters

<ParamField path="promptId" type="integer" required>
  The unique numeric ID of the prompt you want to update.
</ParamField>

## Request Body

All body fields are optional. Send only what you want to change.

<ParamField body="title" type="string">
  Updated display name for the prompt. Must be between **1** and **120** characters.
</ParamField>

<ParamField body="prompt" type="string">
  Updated prompt text. Must be between **1** and **15,000** characters.
</ParamField>

<ParamField body="promptType" type="string">
  Updated prompt modality. Accepted values: `image`, `text`, `video`.
</ParamField>

<ParamField body="platform" type="string">
  Updated platform label.
</ParamField>

<ParamField body="modelId" type="string">
  Updated fal.ai model identifier. Must match `^fal-ai/.+` — for example `fal-ai/recraft/v4.1/text-to-image`. Required if you are changing `promptType` to `image` or `video` and a `modelId` is not already set.
</ParamField>

<ParamField body="aspectRatio" type="string">
  Updated output aspect ratio, e.g. `"16:9"`. Maximum **20** characters.
</ParamField>

<ParamField body="vaultId" type="integer">
  Add the prompt to the vault with this ID. To remove a prompt from a vault, use the vault membership endpoint instead.
</ParamField>

<ParamField body="imageUrl" type="string">
  Updated URI for the image associated with this prompt.
</ParamField>

<ParamField body="referenceMediaUrls" type="array">
  Replacement array of up to **10** reference media URIs. This overwrites the existing list entirely.
</ParamField>

## Example Request

```bash theme={null}
curl -X PATCH https://www.promptbank.club/api/v1/prompts/42 \
  -H 'Authorization: Bearer pb_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Cinematic sunset portrait — golden hour edit",
    "aspectRatio": "16:9"
  }'
```

## Example Response

```json theme={null}
{
  "data": {
    "id": 42,
    "title": "Cinematic sunset portrait — golden hour edit",
    "prompt": "A cinematic portrait at golden hour, warm tones, shallow depth of field",
    "promptType": "image",
    "platform": "fal.ai",
    "status": "active",
    "images": [],
    "vaultIds": [7],
    "createdAt": "2024-06-01T12:00:00Z",
    "updatedAt": "2024-06-03T08:42:00Z"
  },
  "error": null
}
```

A successful update returns HTTP **200 OK** with the full, updated prompt object. Note that `updatedAt` reflects the timestamp of this change.


## Related topics

- [Update Vault Properties — Prompt Bank API Reference](/api-reference/vaults/update.md)
- [Delete Prompt — DELETE /api/v1/prompts/{promptId}](/api-reference/prompts/delete.md)
- [Retrieve a Prompt — GET /api/v1/prompts/{promptId}](/api-reference/prompts/get.md)