Environments

A key is test or live. The author token's env claim must match the key. A mismatch is forbidden. Test and live discussions are separate rows. Test bytes do not reduce the live remaining 1 GiB.

  • Test publishable and test secret keys work without a paid plan.
  • Live config fetch needs active BYO ($9.99) or Hosted ($19.99).
  • Live Hosted writes need active Hosted ($19.99).
  • Live content calls require an author token even when requireAuthorToken is false.
  • Test content calls require a token only when that flag is true. A token you do send is still verified.

GET /api/v1/usage with the secret key returns the meter for that key's environment: { meteredBytes, capBytes, sessionCount }. Session counts are operational totals for the workspace, not an invoice. GET /api/v1/export returns the same environment.

Cancel deletes both environments after 30 days. Until then, export the environment you still need. See API keys.

Related: Limits · Modes · Sessions