API overview

Your backend calls three endpoints with a project API key:

Method	Path	Purpose
`POST`	`/v1/check`	Check entitlement and affordability without mutation
`POST`	`/v1/consume`	Authoritatively decide, deduct credits, and record usage
`POST`	`/v1/events`	Record non-credit usage

Base URLs are deployment-specific. The dashboard’s Developers page shows the configured runtime URL.

Request conventions

JSON request and response bodies
Unexpected JSON fields are rejected
Authorization: Bearer <project API key> on every request
X-Request-ID is echoed when it contains 1–128 allowed ASCII characters; otherwise the runtime generates one
Every response includes a request ID for support and log correlation
Default request body limit: 64 KiB