insufficient_scope

Statut HTTP : 403 · Rejouable : non — un jeton portant le scope manquant est nécessaire.

Cause

Votre jeton est valide et votre identité est reconnue, mais l'endpoint appelé exige un scope que le jeton ne porte pas. Chaque famille de ressources a son scope : lire des données de paie, écrire une DPAE et gérer des webhooks sont trois autorisations distinctes.

Réponse

HTTP/1.1 403 Forbidden
Content-Type: application/problem+json

{
  "type": "https://docs.pesia.fr/partner/errors/insufficient_scope",
  "title": "Insufficient Scope",
  "status": 403,
  "detail": "An error occurred.",
  "code": "insufficient_scope",
  "missing": ["dpae:write"],
  "instance": "/partner/v1/dpae/submissions",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Le detail est générique : l'information utile est dans l'extension missing.

Extensions

Champ	Type	Contenu
missing	string[]	Les scopes exigés par l'endpoint et absents de votre jeton.

Que faire

• Lire missing : il nomme exactement ce qui manque.

• Vérifier les scopes réellement demandés lors de l'obtention du jeton — un scope non demandé n'est jamais accordé implicitement.

• Relire le champ missing de la réponse 403 ci-dessus : il est porté par le corps de l'erreur, pas par une route d'introspection. Pour vérifier qu'un jeton est simplement valide, la route la moins exigeante en scope est :

  curl -s https://api.pesia.fr/partner/v1/organizations/me \
    -H "Authorization: Bearer $TOKEN"

• Si le scope manquant n'est pas accordé à votre intégration, contactez votre interlocuteur Pesia (partenaires@pesia.fr) pour l'ajouter à votre périmètre.

Voir aussi : Scopes · Authentification · Tous les codes d'erreur