Authentication

The Trelent SDK authenticates with a client ID and secret. The SDK exchanges them for short-lived access tokens automatically on each request.

Get credentials

Ask your Trelent admin for a client ID and secret, then pass them to the Client:

from trelent_agents import Client

client = Client(
    client_id="your-client-id",
    client_secret="your-client-secret",
)

Environment variables

You can also read credentials from the environment:

export TRELENT_CLIENT_ID="your-client-id"
export TRELENT_CLIENT_SECRET="your-client-secret"

import os
from trelent_agents import Client

client = Client(
    client_id=os.environ["TRELENT_CLIENT_ID"],
    client_secret=os.environ["TRELENT_CLIENT_SECRET"],
)

Custom API URL

Client defaults to https://agents.trelent.com. Override it when pointing at a different environment:

client = Client(
    api_url="https://api.dev.trelent.com/agent",
    client_id="your-client-id",
    client_secret="your-client-secret",
)

How it works

The SDK calls POST /token on the API with your credentials and the scope needed for the request (e.g. AgentOrchestrator:runs:create).
Tokens are short-lived and cached per scope for the lifetime of the Client.
If a narrow scope is rejected, the SDK transparently retries with a broader one (AgentOrchestrator:runs:*, then AgentOrchestrator:*).

You generally do not need to think about scopes — the SDK picks the right one per call.

Getting started

Core concepts

Importers

Get credentials

Environment variables

Custom API URL

How it works

​Get credentials

​Environment variables

​Custom API URL

​How it works

Get credentials

Environment variables

Custom API URL

How it works