# CNF API

> Use reliable, low-latency endpoints in your applications.

Base URL: https://api.c.nf. Current version: 2.0.0.
Authentication is a Bearer token from https://console.c.nf/account/api.
Endpoints under /v1/public need no token.

## Start here

- [Agent brief](https://api.c.nf/v1/ai): what to send, what comes back, and the rules that are not guessable. Read this one first.
- [Tool definitions](https://api.c.nf/v1/ai?format=json): every endpoint as a tool schema, in Anthropic and OpenAI shapes.
- [OpenAPI 3.1](https://api.c.nf/v1/openapi.json): the full contract.
- [JSON index](https://api.c.nf/v1): the same route table, unrendered.
- [Reference](https://api.c.nf/v1/docs): the human documentation.

## Services

- **Public utilities** (6 endpoints, no authentication) — Small dependable endpoints that need no account: time, address, country, exchange rates and hashes.
- **Account** (5 endpoints) — Who a token belongs to, and what it is allowed to do.
- **DNS** (10 endpoints) — Claim a domain, prove you control it, then manage its records.
- **Credentials** (2 endpoints) — The private credential store behind the credentials tool.
- **Files** (9 endpoints) — Personal file storage: list, upload, edit, share and delete.
- **CDN** (3 endpoints) — Edge caching and traffic for the files you share.
- **SMS forwarder** (4 endpoints) — Messages relayed from your phone, and the keys that let it in.
- **Static sites** (3 endpoints) — Upload a zip, serve a site.
- **Deployments** (3 endpoints) — The form, webhook and shortlink endpoints you have deployed.
- **Domains** (2 endpoints) — Your domain portfolio and its registration data.
- **Packages** (5 endpoints) — Publish releases and read back their versions and download counts.
- **WHOIS** (1 endpoint) — Registration data for a domain, cached and shared with the domain tools.

## Notes

- Responses share one envelope: success, then data or error + message, plus request_id.
- Branch on the `error` code, not on `message`.
- A token acts only for the account that issued it. There is no administrative override.