scope_required
The key was not issued for this operation.
What to do
Reissue the key with the scope the endpoint needs - CONTACT.VIEW to read contacts, PRODUCT.MODIFY to change a product, and so on. Distinct from forbidden, where the permission itself is missing.
Should you try again?
No. The same request will fail the same way. Change something first.
How you'll see it
{
"type": "https://www.obraledger.com/api/errors/scope_required",
"detail": "..."
}
The body also carries a title
and a status. The
detail is written for a person
and we may reword it, so don't match on it. Some failures also carry a
violations list naming the fields
at fault.
Where it comes from
Any call can return this one.
- get List contacts Contacts
- post Create a contact Contacts
- get Get one contact Contacts
- patch Update a contact Contacts
- delete Delete a contact Contacts
- get List products Products
- post Create a product Products
- get Get one product Products
- patch Update a product Products
- delete Delete a product Products
Building something and stuck? Tell us - we'd rather hear it than have you guess.