Skip to main content

FAQ

Should principal_id be a user id?​

Use the most stable billing-owner identifier you already have.

  • If billing is per-user, a stable user id is fine.
  • If billing is shared by an org, team, or workspace, use that stable org/team/workspace id.
  • If ownership can change later, avoid using a transient login or context id directly. Choose a stable internal billing-owner id instead.

Can I retry a timed out write?​

Yes. Retry with the same Idempotency-Key and the same body.

How do I obtain billing_account_id?​

Use POST /mgt/v1/token/issue from your backend and store the mapping.