Let your agent write the integration

The extend-api context file is a compact brief on the API, SDKs, schema rules, sync-vs-async patterns, webhooks, and error handling, so the code your agent generates is right the first time.

Install the skillFull docs

npx skills add extend-hq/extend-agent-plugin --skill extend-api

Install an SDK

Create a key on the Developers dashboard and export it where the agent's code will run. SDK clients read it from the environment and set the auth header and API version for you.

pip install extend-ai
export EXTEND_API_KEY="sk_xxx"

Developers dashboard

What the skill teaches

Installed at the project level as .agents/skills/extend-api/ so it can be committed with your repo. Re-run the same command after API updates.

Authentication header and the x-extend-api-version: 2026-02-09 header required on raw HTTP requests
Regions and base URLs for US1, US2, and EU1, and how to set baseUrl in each SDK
Sync vs. async processing and the create_and_poll / createAndPoll helpers
Webhook signature verification with verifyAndParse / verify_and_parse
Schema rules for extraction, plus copy-paste patterns for parse, extract, classify, and split

Go SDK

Go has no polling or webhook helpers. An agent writing Go should poll and verify signatures manually.

Prefer zero tooling?

The skill is a single file. Copy skills/extend-api/SKILL.md from the extend-agent-plugin repository into .agents/skills/extend-api/ (or ~/.agents/skills/extend-api/ for global use, with a symlink into ~/.claude/skills for Claude Code). Agents that only fetch docs can start from llms.txt.

npx skills add extend-hq/extend-agent-plugin --skill extend-api -g

extend-agent-plugin SKILL.md llms.txt

Minimal example

Parse a hosted document and print its markdown chunks. Each client reads EXTEND_API_KEY from the environment.

import { ExtendClient } from "extend-ai";

const client = new ExtendClient();

const response = await client.parse({
  file: { url: "https://extend-public-files.s3.us-east-2.amazonaws.com/bank_statement_example.pdf" },
});
console.log(response.status);

response.output.chunks.forEach((chunk) => console.log(chunk.content));

Frequently asked questions

npx skills add installs at the project level so the configuration can be committed with your repo. Pass -g to install globally instead.

Re-run the same npx skills add command. The skill is a single SKILL.md, so you can also copy the latest file from the extend-agent-plugin repository.

No. Python, TypeScript, and Java ship create_and_poll / createAndPoll and built-in webhook signature verification; Go has neither, so an agent writing Go should poll and verify signatures manually.

Other ways to connect

MCP server

If your agent: If your agent calls tools from chat (Cursor, Claude, ChatGPT, and other MCP clients)
Give it: The hosted MCP server. OAuth sign-in, nothing to install.

CLI and extend-cli skill

If your agent: If your agent runs one-off and shell-driven document jobs
Give it: The extend CLI and the extend-cli skill generated from its command tree.