Pre-flight a trigger (ready check)
Verifies a fire would be accepted WITHOUT firing: authenticates the key, resolves the trigger in your organization/brand scope, and checks permissions — the same gates a real POST hits. status: "ready" returns the contract a caller needs to wire an external service: details.payloadSchema, details.endpoint, and the matched published consumers (publishedAutomations, publishedTransactionalEmails, counts).
Use it while integrating, before anything is published: a ready trigger with counts.automations: 0 accepts fires but starts no runs until an attached automation is published.
Response-shape note — responds with the same legacy fire envelope as the POST ({ success, status, code, message, receivedAt, details }).
Authorizations
Send your Brew API key as Authorization: Bearer brew_xxx.
Headers
The brand this request acts on. REQUIRED for organization-scoped credentials (otherwise 400 BRAND_ID_REQUIRED — there is no default brand); list ids with GET /v1/brands. Brand-scoped credentials may omit it, and sending a different brand returns 403 BRAND_SCOPE_MISMATCH. A brand outside your organization returns 404 BRAND_NOT_FOUND.
1 - 64Path Parameters
Trigger id returned by POST /v1/automations/triggers. Custom triggers use tri_… ids; integration triggers use composite ids (e.g. clerk:org_…:brand_…:user.created, URL-encode the colons).
1 - 256"tri_signup"
Response
Ready: the key, scope, and permissions all pass; details carries the payload contract and matched consumers.
Discriminator for the response category. Pairs with code. A trigger with no published automation attached returns status: "failed" + code: "NO_PUBLISHED_AUTOMATION" (HTTP 422). Successful fires always return status: "triggered".
triggered, idempotent_replay, ready, invalid_api_key, invalid_json, failed, forbidden, payload_mismatch, trigger_event_not_found ISO-8601 timestamp the request was processed at.