# KCS - Erro de Acesso Negado (40301) na API

## ❌ Erro de Acesso Negado (40301) na API

🕒 Tempo aproximado para leitura: 00:01:00 min

***

### ❓ Dúvida:

Ao tentar consumir uma rota específica da API do Tiflux, o cliente recebe o erro {"error\_code": 40301, "message": "Access Denied - You cannot access this route", ...}. O cliente precisa entender o motivo desse erro.

```
{
  "error_code": 40301,
  "message": "Access Denied - You cannot access this route",
  "detail": {
    "error": [
      "You are not authorized to access this page."
    ]
  }
}
```

***

### 🔎 Causa:

O código de erro 40301 e a mensagem "Access Denied" indicam uma falha de autorização ou permissão.

 O **usuário ou a chave** de API utilizada para fazer a chamada **não possui as permissões** necessárias para acessar aquela rota ou os dados específicos solicitados. A causa mais provável é que um dos parâmetros inseridos na chamada da API (como um ID de cliente, de ticket ou de usuário) não está acessível ao **perfil de permissão do usuário** da API.

***

### ✅ Solução:

O cliente deve verificar as seguintes possibilidades para solucionar o erro:

1. Verificar **Permissões do Usuário**: Certifique-se de que o usuário ou token de API possui todas as permissões de leitura/escrita necessárias no Tiflux para a rota que está sendo consumida.
2. Revisar os **Parâmetros**: Verifique se algum parâmetro na chamada da API (por exemplo, `client_id`, `user_id`, ou `ticket_id`) está fazendo referência a um recurso que está fora do escopo de acesso do usuário logado na API.
3. Consultar a **Documentação da API**: Verifique a documentação oficial da API para confirmar os requisitos de permissão para a rota específica em uso.
   1. [**https://api.tiflux.com/api/v2/**](https://api.tiflux.com/api/v2/)

Se as permissões parecerem corretas, mas o erro persistir, o cliente deve entrar em contato com o suporte técnico, fornecendo o *endpoint* e a chave utilizada (se for o caso) para análise.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/api/kcs-erro-de-acesso-negado-40301-na-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.