Authentication

Authenticate with the Notte API

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

All API requests require a Bearer token in the Authorization header.

Get your API key

1. Sign in to the Notte Console
2. Open the API keys page
3. Generate or copy your API key

Using the API key

Set your API key locally before calling the REST API or using either SDK:

export NOTTE_API_KEY=your_api_key_here

Both SDKs read NOTTE_API_KEY automatically:

client.py

from notte_sdk import NotteClient

client = NotteClient()

If you want the full machine-readable API contract, the OpenAPI spec is available at:

https://api.notte.cc/openapi.json

curl https://api.notte.cc/sessions \
  -H "Authorization: Bearer $NOTTE_API_KEY"

Request headers

Header	Required	Description
Authorization	Yes	Bearer token with your API key
Content-Type	Yes	application/json for POST/PATCH requests