# Todyl External API

**Canonical:** https://apis.io/apis/todyl/todyl-external-api/  
**Provider:** Todyl — https://apis.io/providers/todyl/  
**Base URL:** https://api.todyl.com  
**Documentation:** https://www.todyl.com/support

Todyl External API is published by [Todyl](https://apis.io/providers/todyl/) on the [APIs.io](https://apis.io/) network. Tagged areas include Security, Devices, and Billing. The published artifact set on APIs.io includes authentication docs and rate-limit docs.

Todyl's External API is a path-versioned REST API served from https://api.todyl.com. Probing it unauthenticated returns Todyl's own JSON error envelope ({"error":{"code":"auth_missing_token","message":"Credentials missing or invalid.","request_id":"req_..."}}), and supplying the X-Todyl-Client-Id / X-Todyl-Access-Token header pair changes the code to auth_malformed_token, confirming those are the credential headers the service recognises. Tokens are minted in the Todyl portal under Account -> Developer APIs -> External API Tokens. Every path probed — including /openapi.json, /v1/openapi.json and /.well-known/* — answers 401, so no machine-readable contract is reachable without credentials.

## Machine-readable artifacts (6)

- **Authentication** — https://raw.githubusercontent.com/api-evangelist/todyl/refs/heads/main/authentication/todyl-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/todyl/refs/heads/main/errors/todyl-error-codes.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/todyl/refs/heads/main/rate-limits/todyl-rate-limits.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/todyl/refs/heads/main/conventions/todyl-conventions.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/todyl/refs/heads/main/lifecycle/todyl-lifecycle.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/todyl/refs/heads/main/apis.yml

## Tags

Security, Devices, Billing

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/todyl/todyl-external-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/todyl/.