---
title: "API Authorization Error When Trying to Open the Agent"
slug: "troubleshooting-api-authorization-error-when-trying-to-open-the-agent"
updated: 2026-03-04T12:03:50Z
published: 2026-03-04T14:36:49Z
canonical: "docs.senhasegura.io/troubleshooting-api-authorization-error-when-trying-to-open-the-agent"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API Authorization Error When Trying to Open the Agent

## API Authorization Error When Trying to Open the Agent

### Scenario

When trying to open the EPM agent, you may encounter an API authorization error. This issue can occur due to the `senhasegura-api-authorization-service` container not being installed or started correctly. This guide provides step-by-step instructions to resolve this issue, ensuring that the necessary service is properly installed and running.

### Symptom

- API authorization error when trying to open the EPM agent.

### Likely Cause

- The `senhasegura-api-authorization-service` container is not installed or not started correctly.

### Solution

Follow the steps below to resolve the API authorization error:

1. **List Active Containers:**
  - Open the [admin terminal](/v4-2/docs/administration-ssh-access) and run the following command to check the running containers:

```
docker ps
```
  - Confirm if the `senhasegura-api-authorization-service` container is listed. If it is not, proceed with the next steps.
2. **Reinstall the Package:**
  - If the container is not present or installed, reinstall the necessary package with the following command:

```
apt reinstall senhasegura-api-authorization-service
```
  - This will ensure that the container is downloaded and installed again.
3. **Start the Service:**
  - After reinstalling, start the service with the command below:

```
systemctl start senhasegura-api-authorization
```
  - This command will ensure that the service is running.
4. **Generate a New API Key:**
  - With the service running, generate a new API key using the following command:

```
orbit api keygen
```
  - This command creates a new API key that will be used for authorization.
5. **Restart the Service:**
  - Finally, restart the system to ensure all changes are applied correctly:

```
systemctl restart senhasegura-api-authorization
```

### Conclusion

After following the steps above, the API authorization error when trying to open the agent should be resolved. If the error persists, contact technical support for further assistance.