# Use with AI tools

> Markdown versions of every page, llms.txt, and instructions to give your coding agent.

These docs are written to be read by people and by AI tools alike.

- Add `.md` to any page address for its Markdown, for example [/webhooks.md](/webhooks.md).
- Send `Accept: text/markdown` to any page address and you get the same Markdown.
- [/llms.txt](/llms.txt) lists every page with a one-line summary.
- [/llms-full.txt](/llms-full.txt) is the whole documentation, reference included, in one file.
- [/openapi.json](/openapi.json) is the OpenAPI 3.1 description of every endpoint and event.

## Instructions for your coding agent

Paste this into your project's `AGENTS.md`, `CLAUDE.md` or editor rules when you build against NOWScale:

```markdown
## NOWScale API
- Docs: https://docs.nowscale.com/llms-full.txt (OpenAPI: https://docs.nowscale.com/openapi.json)
- Base URL https://api.nowscale.com/v1, header `Authorization: Bearer $NOWSCALE_API_KEY`. Never put the key in client code.
- Send `Idempotency-Key` on every POST that creates something; retry 429 after Retry-After and 5xx with backoff.
- Errors are application/problem+json; branch on `code`.
- Verify webhook signatures (Standard Webhooks, secret starts with whsec_) on the raw body before parsing.
- Scheduling a TikTok target needs `privacy_level` chosen by the creator and `consent: true` after showing TikTok's consent text.
```

## Keys for agents

Give an agent its own key with only the permissions it needs, limited to the Projects it works on, and an expiry date. Keys without `posts:publish` can prepare posts but never schedule them without review.