Azta API skill

Install the Azta API agent skill in your coding agent, so it writes correct, retry-safe integrations with the Azta API.

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.

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.

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

For every project, for example:

Terminal
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.

Terminal
mkdir -p .claude/skills/azta-api && curl -fsSL https://docs.azta.ai/skills/azta-api.tar.gz | tar -xz -C .claude/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.

Terminal
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 from annotation offsets.
  • Errors and limits and the retry policy.
  • Webhooks and their signature check.
  • Lookups and moving from the OpenAI SDK.

On this page