Update a prompt

PATCH

https://api.respan.ai/api/prompts/:prompt_id/

Update prompt metadata such as its name or description.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

prompt_idstringRequired

The unique prompt identifier.

Request

This endpoint expects an object.

namestringOptional

Updated prompt name.

descriptionstringOptional

Updated prompt description.

Response

Prompt updated successfully.

idstringOptional

namestringOptional

descriptionstring or nullOptional

updated_atdatetimeOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

$	curl -X PATCH https://api.respan.ai/api/prompts/prompt_id/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"id": "prompt_abc123",
3	"name": "Enhanced Customer Support Assistant",
4	"description": "Improved version with better context handling",
5	"updated_at": "2026-01-21T12:30:00Z"
6	}