API Reference

The PromptDeploy API lets you programmatically access prompt history and send quality signals from your application.

Base URL

https://promptdeploy.com/api/v1

Authentication

All API requests require a Bearer token. Create an API key from Settings → API Keys in the PromptDeploy dashboard.

curl -H "Authorization: Bearer pd_live_abc123..." \
  https://promptdeploy.com/api/v1/prompts/{prompt_id}/history

See Authentication for details.

Endpoints

Method	Path	Description
`GET`	`/prompts/:id/history`	List edit history for a prompt
`POST`	`/prompts/:id/signals`	Record a quality signal

Prompt IDs

API endpoints use the prompt's public ID (format: pmt_abc123...), not the internal database ID. You can find a prompt's public ID on its detail page in the dashboard.

Response format

All responses use a consistent JSON structure:

{
  "data": { ... }
}

Error responses use:

{
  "error": {
    "code": "error_type",
    "message": "Human-readable description"
  }
}

See Errors for the full list of error codes.

Rate limits

API requests are subject to rate limits that vary by plan. See Rate Limits.

← Previous Variables Next → Authentication