---
title: "authorization_failed"
description: "Error cause: authorization_failed"
canonical: "https://studio.inttegro.dev/e/c-authorization_failed"
format: inttegro-machine-docs/v1
language: "PHP"
sdk_version: "v14.1.1"
reader_profile: optional
reader_manifest: "https://studio.inttegro.dev/machine/php/readers/index.json"
reader_identification: "Optional: declare your client only if known and your current-session capabilities; use reader_manifest for supplemental recommendations."
preamble_estimated_tokens: 361
model_token_report: "https://studio.inttegro.dev/machine/token-report.json"
preamble_questions: 5
preamble_source: "general"
recommended_mcp_tools: []
estimated_tokens: 859
token_estimate_method: "utf8_bytes_divided_by_4"
---

## Machine preamble

**Summary:** Error cause: authorization_failed This PHP representation uses the selected SDK's native names wherever Studio has a verified mapping.

### Five questions

#### Q1. When should the reader use authorization_failed?

Use this page as orientation before selecting the narrower guide or reference that owns the implementation contract.

#### Q2. What is authoritative on this page?

Use this page for orientation; follow its canonical SDK, guide, API, or MCP links for exact contracts.

#### Q3. What page-specific constraint matters most?

Use the page to choose a canonical next source instead of treating summary material as a complete implementation contract.

#### Q4. Can Inttegro MCP materially help with this task?

No catalog ability is sufficiently specific to recommend for this page. Use the documentation directly; consult the MCP catalog only if the task later requires governed live account context or a supported operation.

#### Q5. How should the reader verify the answer and continue?

Select the narrowest linked guide or reference, apply its stated completion condition, and verify against authoritative resource state when the task changes data. Continue with [contact_customer_support](https://studio.inttegro.dev/machine/php/e/f-contact_customer_support.md) and [authentication_failed](https://studio.inttegro.dev/machine/php/e/c-authentication_failed.md) when those concerns enter scope.

## Document content

# authorization\_failed

Error cause indicating credentials were authenticated successfully but lack permission to perform the requested operation.

## What this means

Your API key is valid, but it does not allow access to the requested resource or operation. Use a key with the required permissions and access to the resource identified in your request.

Similarly, if you attempt to access an endpoint that requires permissions your API key does not have, you will encounter this error. It returns HTTP `403` and requires a key with the necessary permissions or help from support.

## Example error response

```json
{
  "error": {
    "type": "bad_request",
    "cause": "authorization_failed",
    "code": "1403",
    "message": "authorization failed",
    "detail": "Your API key does not have permission to access this resource.",
    "fix_code": "change_request_parameters",
    "url": "https://studio.inttegro.com/e/1403"
  }
}
```

## Related errors

- [authentication\_failed](https://studio.inttegro.dev/machine/php/e/c-authentication_failed.md) - Invalid credentials
- [contact\_customer\_support](https://studio.inttegro.dev/machine/php/e/f-contact_customer_support.md) - May need support for permission issues