🔑Authentication & Security

API Key Authentication

All requests to the Anunzi API require authentication via an API Key, which must be included in the Authorization header of each request.

• 📌 Important:

  • The API Key is provided by the Anunzi team and is unique for each client.

  • Do not share your API Key with third parties.

  • Always use secure connections (HTTPS).

Example of authentication in a request:

curl --request GET \
     --url https://api.anunzi.net/v2/assistants \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer YOUR_API_KEY'

---

Model ID

The Model ID is a unique identifier used to assign assistants, calls, or actions to a specific client within Anunzi.

• 📌 Important:

  • The Model ID is also provided by the Anunzi team.

  • It is required in multiple API requests to specify which assistant the actions apply to.

Example of using Model ID in a request:

{
  "model_id": "151531531x15361351",
  "name": "Test Assistant"
}

---

⚠️ Error Handling & Status Codes

To properly handle API responses, it is essential to understand status codes and how to react to errors.

Common Response Codes

Code	Meaning	Recommended Action
200 OK	Successful request.	Process the response as expected.
400 Bad Request	The request contains errors or invalid parameters.	Check and correct the data sent.
401 Unauthorized	Missing or incorrect API Key.	Ensure the Authorization: Bearer API_KEY header is included correctly.
403 Forbidden	You do not have permission to access this resource.	Contact the Anunzi team.
404 Not Found	The requested resource does not exist.	Verify that the endpoint and IDs are correct.
429 Too Many Requests	API rate limit exceeded.	Implement a retry mechanism and wait before retrying.
500 Internal Server Error	An unexpected error occurred on the server.	Try again later or contact Anunzi support.