Authentication

Create a deployment key in the Sutro app under API Keys. Keys are scoped to one deployment.

export SUTRO_API_URL="https://your-sutro-deployment.example.com"
export SUTRO_API_KEY="sk_..."

SUTRO_API_URL accepts the deployment origin with or without /v1. To store both values in ~/.sutro/config.json instead:

sutro login

The SDK resolves credentials in this order:

Explicit Sutro(api_url=..., api_key=...) values or setters
SUTRO_API_URL and SUTRO_API_KEY
Values saved by sutro login

You can also update the shared client at runtime:

import sutro as so

so.set_api_url("https://your-sutro-deployment.example.com")
so.set_api_key("sk_...")

A partial environment pair never borrows its missing value from saved configuration. Changing the deployment URL clears the current key so it cannot be sent to another deployment. Direct API calls use the same key:

Authorization: Key sk_...

Product

MCP

Python SDK

API

Authentication

Authentication

​Authentication

Authentication