Bulk update, commit, or deploy prompts

Process 1 to 100 prompt operations sequentially in request order using exact prompt_id matching. Each item runs in its own transaction, so a failed item is rolled back without undoing successful items. update changes model configuration on the latest draft and does not accept content fields such as messages, variables, or description; commit snapshots the latest draft; deploy promotes the latest committed version. A later duplicate successful commit or deploy for the same prompt in one request is returned as an indexed error. This endpoint inherits the caller’s configured API-key or JWT rate limits; it has no fixed endpoint-specific RPM.

Process 1 to 100 prompt operations sequentially in request order using exact `prompt_id` matching. Each item runs in its own transaction, so a failed item is rolled back without undoing successful items. `update` changes model configuration on the latest draft and does not accept content fields such as `messages`, `variables`, or `description`; `commit` snapshots the latest draft; `deploy` promotes the latest committed version. A later duplicate successful `commit` or `deploy` for the same prompt in one request is returned as an indexed error. This endpoint inherits the caller's configured API-key or JWT rate limits; it has no fixed endpoint-specific RPM.

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.

Request

This endpoint expects an object.

requestslist of objectsRequired

Prompt operations. Error indices refer to this zero-based array.

Response

All prompt operations succeeded.

success_countinteger>=0

Number of items successfully processed.

error_countinteger>=0

Number of items that failed.

errorslist of objects

Item-level failures, keyed by zero-based input index.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

429

Too Many Requests Error

$	curl -X POST https://api.respan.ai/api/prompts/bulk/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"requests": [
>	{
>	"action": "update",
>	"body": {
>	"model": "gpt-4o-mini",
>	"temperature": 0.25,
>	"max_tokens": 512
>	},
>	"prompt_id": "prm_customer_support"
>	},
>	{
>	"action": "commit",
>	"prompt_id": "prm_customer_support",
>	"body": {
>	"description": "Tune production configuration"
>	}
>	},
>	{
>	"action": "deploy",
>	"prompt_id": "prm_customer_support"
>	}
>	]
>	}'

1	{
2	"success_count": 3,
3	"error_count": 0,
4	"errors": []
5	}