All integrations

Raw HTTP

Reviewed headless integrations without a supported SDK.

PreviewWebhookenv var
progress (primary) Live Activity preview
raw API call

Source/API preview. Use Bearer authentication only with a narrowly scoped secret-manager credential; interactive users should pair instead.

Setup

  1. 1Use this only when no higher-level reviewed surface fits.
  2. 2Inject a narrowly scoped CHIRP_API_KEY from the runtime secret manager; never put it in a URL or prompt.
  3. 3Send constrained state and close every activity on success and failure.
  4. 4Verify provider acceptance and the phone's delivery acknowledgement separately. Never call an accepted event delivered.
curl
curl --fail-with-body \
  -H "Authorization: Bearer $CHIRP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"schema_id":"@agent","data":{"agentName":"job","statusMessage":"working","state":"working"}}' \
  https://api.chirpapp.dev/v1/activity/start