The Atla Insights Data API provides programmatic access to project data in Atla’s platform for monitoring and improving AI agents. For details on the data model, see the documentation. You can interact with the Data API through HTTP requests from any programming language or through our Python SDK.

​
Installation

Install the Python SDK: 
pip install atla-insights

​
Authentication

All API requests must include an API key for authorization. You can get an API key from your Insights dashboard. When using the Python SDK, you can set your API key either in the client constructor or as the ATLA_INSIGHTS_TOKEN environment variable. The SDK will then handle authorization automatically. For HTTP requests, include an Authorization header as follows: 
Authorization: Bearer $ATLA_INSIGHTS_TOKEN

​
Content types

The Atla API accepts and returns JSON in request and response bodies. Include the following header in your API requests: 
Content-Type: application/json
As with authorization, the Python SDK handles content type headers automatically.