Use the Agent REST API

The base URL is:

https://api.txcast.com/agent/v1

The authoritative operation and schema reference is the live OpenAPI 3.1 document. This site does not publish a second schema copy.

Read context

curl --fail-with-body \
  -H "Authorization: Bearer $TXCAST_AGENT_TOKEN" \
  https://api.txcast.com/agent/v1/context

The organisation comes from the credential. Callers cannot select an organisation ID.

Send a mutation

Every REST mutation requires:

Authorization: Bearer txc_…
Txcast-Agent-Name: your-client-name
Txcast-Agent-Version: your-client-version
Idempotency-Key: a-stable-key-for-this-exact-operation
Content-Type: application/json

The agent name and version are printable 1–64 character self-reported audit labels. They are not authentication.

Browser isolation

Agent routes accept bearer credentials and reject browser session cookies, including requests that supply both. A valid bearer may omit Origin; an untrusted supplied origin is still rejected. Existing browser routes do not accept agent bearers.

Sensitive endpoints

OpenAPI marks endpoints that require user confirmation with txcast and Anthropic-compatible extensions. Clients should surface these prompts, but must still rely on scopes, grants, version checks, and wallet confirmation for enforcement.