# Telnyx API

> Public REST API for voice, messaging, numbers, verify, fax, AI inference,
> and account management. Base URL: https://api.telnyx.com/v2

## What this surface is for
- Programmatic integrations and agent function-calling against api.telnyx.com
- Discovering OpenAPI specs and operation catalogs
- Looking up authentication, rate limits, and error recovery flows

## Canonical docs and specs
- API reference: https://developers.telnyx.com/api
- OpenAPI discovery: https://telnyx.com/.well-known/openapi.json
- Public OpenAPI spec: https://raw.githubusercontent.com/team-telnyx/openapi/master/openapi/spec3.json
- API catalog: https://telnyx.com/.well-known/api-catalog
- Agent capabilities index: https://telnyx.com/.well-known/ai-capabilities.json

## Authentication
- Bearer API key in the Authorization header.
- Get a key via the agent signup flow: https://telnyx.com/agent-signup.md
- OAuth 2.0 metadata: https://telnyx.com/.well-known/oauth-authorization-server

## Rate limits and recovery
- Rate-limit data: https://telnyx.com/ai/rate-limits.json
- Errors return a top-level errors[] array. Each error has code, title,
  detail, and (where available) meta.url linking to error documentation.
- Retry on HTTP 429 (respect the Retry-After header) and on documented
  transient 5xx responses (502, 503, 504). Do not retry other 4xx
  responses.
- Error reference: https://developers.telnyx.com/docs/overview/errors
- Agent error recovery guidance: https://telnyx.com/agents/start

## Agent fast path
- Agent entry point: https://telnyx.com/agents/start
- Site-wide index: https://telnyx.com/llms.txt
- AI namespace index: https://telnyx.com/ai/llms.txt
- Pricing markdown: https://telnyx.com/pricing.md