# payment_required

> A payment method or plan upgrade is needed. The workspace has no valid payment method, or the last payment failed.

**A payment method or plan upgrade is needed.** The workspace has no valid payment method, or the last payment failed.

- **HTTP status:** `402 Payment Required`
- **CLI exit code:** `5` (quota or spend cap)
- **Retry:** not as it is; the same request will fail the same way until the cause is fixed

## How to fix it

Add a card or change plan in Settings, Billing.

## What the response looks like

```json
{
  "type": "https://guv.dev/errors/payment_required",
  "title": "A payment method or plan upgrade is needed",
  "status": 402,
  "code": "payment_required",
  "detail": "The workspace has no valid payment method, or the last payment failed.",
  "fix": "Add a card or change plan in Settings, Billing.",
  "docs_url": "https://guv.dev/errors/payment_required",
  "request_id": "req_01jbx2m9k7q4r8t5v6w3y0z1rq"
}
```

The `code` field is stable: match on it, not on `title` or `detail`, which may be reworded.