curl quickstart

Install the SDK, copy the example, and make your first call -- the identity whoami lookup. It is read-only, so it is safe to run as-is.

1

Prerequisites

You need an AgentRouter API key and the API base URL.

  • Create an API key with the Platform API type -- it is shown once, as <keyid>.<secret>. Copy it now.
  • Base URL https://api.tetrate.ai (or your tenant's). Set AGENTROUTER_API_KEY and optionally AGENTROUTER_BASE_URL in your environment.
2

Install

No install required. curl plus your API key is enough.

Install
export AGENTROUTER_API_KEY=<keyid>.<secret>
export AGENTROUTER_BASE_URL=https://api.tetrate.ai   # optional; defaults to prod
3

Your first call -- whoami

Resolve the identity behind your API key with a read-only GET /v1/me call. Copy the file below. Paste the command below into your shell.

curl "${AGENTROUTER_BASE_URL}/v1/me" \
  -H "Authorization: Bearer ${AGENTROUTER_API_KEY}"

← All languages · Download SDKs · API reference