HTTP 402, billing and entitlements

BILL-001

Payment required.

What it means

The workspace is read-only because a trial lapsed or an invoice is outstanding. Reading, exporting, billing, invitations, and withdrawal from the corpus all keep working: a boundary that traps the customer instead of the product would be the worse bug.

What to do

Settle the outstanding invoice. Nothing is deleted while a workspace is read-only, and paying restores it.

The response

Every failure arrives in this shape. The trace_id is worth keeping: it identifies the request in our logs and carries nothing about your data.

{
  "type": "https://shiftgraph.dev/errors/BILL-001",
  "title": "Payment required.",
  "status": 402,
  "code": "BILL-001",
  "trace_id": "01J8Z…"
}

Related codes

Plan state and the payment boundary. ShiftGraph invoices and is paid by transfer, so nothing here involves a stored card.

• BILL-002A plan change is already in progress.HTTP 409
• BILL-003Downgrade needs quota resolution first.HTTP 400
• BILL-004Unknown plan or interval.HTTP 400
• BILL-005Billing is not configured for this organization.HTTP 400

The full error reference, or write to support@shiftgraph.dev with the trace id.