Webhooks#

Pass webhook_url when you create a run and PromptPotter POSTs a JSON event to it as the loop progresses — no polling required.

Events

round.completed

Fired after each scored round, clean or escalated.

run.completed

The loop converged or hit rounds; payload includes the best prompt.

run.failed

The run stopped on an error; payload includes a reason.

Payload

POST {your webhook_url}
{
  "event": "round.completed",
  "run_id": "run_8fK2a",
  "round": 5,
  "best_score": 0.82
}