insufficient_permissions

HTTP 403 · The key is missing a specific permission.

What causes it

A handler rejected the call because the key lacks a named permission. It is the more precise sibling of `forbidden`; the shared request guard returns `forbidden` instead, so treat the two identically in your code.

What to do

Ask Vaki to add the permission the endpoint requires. All required permissions must be present — it is an AND, not an OR.

Retry?

No — the same request produces the same answer.

The response

{
  "type": "https://developers.vaki.co/errors/insufficient_permissions",
  "title": "…",
  "status": 403,
  "code": "insufficient_permissions",
  "detail": "…",
  "instance": "/v1/checkout_links"
}

Branch on code, never on title or detail. The full list of codes, and the shape of the problem document, is on Errors.