# Azta API skill

The `azta-api` skill teaches your coding agent the Azta API at `https://api.azta.ai/v1`: authentication and key formats, creating and polling responses, the `Idempotency-Key` rule that prevents double charges, rendering sources and annotations, errors and retries, webhook verification and lookups. It holds a short `SKILL.md` and five references, one of them generated from this site's OpenAPI document.

It states no prices. Costs are on [Pricing](/guides/pricing).

## Install with the skills CLI

The skills CLI reads this site's discovery index at `https://docs.azta.ai/.well-known/agent-skills/index.json`. Pick your agent. Add `-g` to install for every project instead of the current one.

```bash tab="Claude Code"
npx skills@1.7.4 add https://docs.azta.ai --skill azta-api --agent claude-code
```

```bash tab="Codex"
npx skills@1.7.4 add https://docs.azta.ai --skill azta-api --agent codex
```

```bash tab="Cursor"
npx skills@1.7.4 add https://docs.azta.ai --skill azta-api --agent cursor
```

```bash tab="GitHub Copilot"
npx skills@1.7.4 add https://docs.azta.ai --skill azta-api --agent github-copilot
```

For every project, for example:

```bash
npx skills@1.7.4 add https://docs.azta.ai --skill azta-api --agent claude-code -g
```

## Install by hand

The skill is one archive. Extract it into the folder your agent reads skills from.

```bash tab="Claude Code (project)"
mkdir -p .claude/skills/azta-api && curl -fsSL https://docs.azta.ai/skills/azta-api.tar.gz | tar -xz -C .claude/skills/azta-api
```

```bash tab="Claude Code (global)"
mkdir -p ~/.claude/skills/azta-api && curl -fsSL https://docs.azta.ai/skills/azta-api.tar.gz | tar -xz -C ~/.claude/skills/azta-api
```

```bash tab="Codex (project)"
mkdir -p .agents/skills/azta-api && curl -fsSL https://docs.azta.ai/skills/azta-api.tar.gz | tar -xz -C .agents/skills/azta-api
```

```bash tab="Codex (global)"
mkdir -p ~/.agents/skills/azta-api && curl -fsSL https://docs.azta.ai/skills/azta-api.tar.gz | tar -xz -C ~/.agents/skills/azta-api
```

```bash tab="Cursor (project)"
mkdir -p .agents/skills/azta-api && curl -fsSL https://docs.azta.ai/skills/azta-api.tar.gz | tar -xz -C .agents/skills/azta-api
```

```bash tab="Cursor (global)"
mkdir -p ~/.cursor/skills/azta-api && curl -fsSL https://docs.azta.ai/skills/azta-api.tar.gz | tar -xz -C ~/.cursor/skills/azta-api
```

## Check the download

`https://docs.azta.ai/.well-known/agent-skills/index.json` lists the skill with a `digest` of the form `sha256:<hex>`, the SHA-256 of the archive. The entry's `url` is relative, so resolve it against the index URL.

```bash
curl -fsSL https://docs.azta.ai/skills/azta-api.tar.gz | shasum -a 256
```

## What it covers

- Keys and the sandbox, and why to start with a sandbox key.
- Create, stream, poll and cancel, `depth` and follow-up questions.
- `Idempotency-Key` on every `POST`, and what a retry without it costs.
- Rendering [sources](/guides/sources) from annotation offsets.
- [Errors and limits](/guides/errors) and the retry policy.
- [Webhooks](/guides/webhooks) and their signature check.
- [Lookups](/guides/lookups) and moving from the [OpenAI SDK](/guides/openai-sdk).