forbidden

Plugin API error forbidden — API key lacks the required scope.

HTTP 403 · not retryable

Authentication succeeded, but the effective scope set (api key ∩ plugin installation) does not include the scope the endpoint requires.

Required scopes

EndpointScope
POST /jobs, POST /jobs/batchplugin.jobs:create
GET /jobs, GET /jobs/{id}, GET /me, GET /presets, POST /jobs/{id}/refresh-urlplugin.jobs:read
DELETE /jobs/{id}plugin.jobs:cancel
POST /assets/uploadplugin.assets:upload
POST /webhooks/{id}/replay, POST /installations/{id}/rotate-hmacplugin.webhooks:manage / plugin.installations.manage

How to fix

  • Re-issue the API key with the missing scope, or expand the installation's scope set in settings.
  • Remember the installation scopes upper-bound the key scopes — narrowing the installation also narrows every key tied to it.