---
title: "Update a Prompt Payload"
method: PUT
path: "/v1/prompts/{id}/payloads/{payloadID}"
tags: ["Prompt Payloads"]
---

# Update a Prompt Payload

`PUT /v1/prompts/{id}/payloads/{payloadID}`

Updates an existing sample payload's variables and/or optional name. Only editors can update.

## Path parameters

- `id` string, uuid, required
- `payloadID` string, uuid, required

## Request body

- UpdatePromptPayloadRequest
  - `name` string — Optional name for this sample payload.
  - `variables` object — JSON object containing variable names and sample values.

## Response `200`

Prompt payload updated successfully

- object
  - `payload` PromptPayload, required
    - `id` string, uuid, required — Unique payload identifier.
    - `prompt_id` string, uuid, required — Reference to parent Prompt ID.
    - `name` string, nullable — Optional name for this sample payload.
    - `variables` object, required — Standard JSON object containing variable names and sample values.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Prompt or payload not found

---

[API](https://skmtc.net/px0-ai/apis/px0-api.md) · [All operations](https://skmtc.net/px0-ai/apis/px0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/px0-ai/px0-api/versions/3ed72443989d/schema)