HTTP API#
Drive PromptPotter from any service over REST. Start a run, follow rounds as they land, and pull the winning prompt. All requests are JSON over HTTPS against:
https://app.promptpotter.dev/api/v1Endpoints
POST /runs Queue an optimization run GET /runs/{id} Fetch run status + best so far GET /runs/{id}/rounds Stream rounds as they land GET /runs/{id}/best Get the winning prompt Authentication Bearer API keys Webhooks Push events to your service
Note
Every request is authenticated with a workspace API key — see Authentication.