Create grant
POST/grants
Create a grant issuance for a billing user under a billing account.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 409
- 422
- 429
- 500
- 503
Idempotent replay
Created
Bad Request
Unauthorized
Forbidden (realm/account mismatch, billing_account_id not derived from session/principal, or insufficient role)
Conflict (idempotency body mismatch, duplicate adjustment, or an attempted economic-identity change to a provider-mapped Catalog Price). The latter returns BILLING.CATALOG_PRICE_PROVIDER_IDENTITY_IMMUTABLE; create a new local Price for different product, currency, unit amount, recurrence interval, recurrence count, or Subscription Group.
Unprocessable Entity (validation, visibility, or binding/meter unresolved)
Rate limited
Response Headers
Retry-After
Seconds to wait before retry.
Internal Server Error
Provider unavailable / transient failure