Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hexelstudio.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

All Hexel Studio API requests require a Bearer token from STS. Two ways to obtain one.

​
API Key

Best for development, scripts, and quick testing.
  1. Go to the Console → IAM → Service Users
  2. Create a service user and generate an API key
  3. Exchange it for a Bearer token:
from hexel import Hexel
client = Hexel(api_key="your_api_key")
# Token exchange happens automatically

​
OAuth Client Credentials

Best for production services and server-to-server communication.
  1. Go to the Console → IAM → Service Users
  2. Create an access client with client_id and client_secret
  3. Exchange for a Bearer token:
from hexel import Hexel
client = Hexel(client_id="your_client_id", client_secret="your_client_secret")

​
Token Lifetime

Tokens expire after 15 minutes. The SDKs handle refresh automatically. If using curl, re-exchange before expiry.

​
Environment Variables

# API Key auth
export HEXEL_API_KEY="your_api_key"

# OAuth auth
export HEXEL_CLIENT_ID="your_client_id"
export HEXEL_CLIENT_SECRET="your_client_secret"
The SDKs and CLI read these automatically.

​
Security

  • Never expose keys in client-side code
  • Use environment variables or secret managers
  • Use OAuth client credentials in production
  • Rotate keys periodically
  • Use separate keys per environment