API errors

forbidden

The credentials are valid, but this operation is not allowed. The `detail` field says why.

403application/problem+json

What it means

Authentication succeeded, so this is not a token problem. Two resources in the URL do not belong together, such as a package that is not on that eSIM, or an account limit on the number of profiles has been reached.

A reference that is not yours at all does not produce this code; it returns not_found. A feature that is not enabled returns feature_not_enabled.

403 · application/problem+json

{
  "type": "https://developers.firsty.app/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Package does not belong to this eSIM",
  "code": "forbidden"
}

How to handle it

Read detail. It names the mismatched pair or the limit.
Fetch the parent's own listing to confirm which children belong to it.
Do not retry unchanged.

Errors reference