Clarify APIOpenAPI Spec
Machine-readable API specification
The full Clarify API is described in an OpenAPI 3.1 specification. It's the same contract that powers the API Reference.
Download
https://api.clarify.ai/swagger-jsoncurl -o clarify-openapi.json https://api.clarify.ai/swagger-jsonUse cases
-
Feed it to an AI agent. Point a coding agent or custom assistant at the spec so it knows every endpoint, parameter, and field before it writes a single request. Frameworks that ingest OpenAPI can turn each operation into a callable tool definition automatically. See AI Agents for the skill, MCP server, and direct-access options.
-
Generate typed clients in TypeScript, Python, Go, or any language with OpenAPI tooling. For example, generate TypeScript types with
openapi-typescript:npx openapi-typescript https://api.clarify.ai/swagger-json -o clarify-api.d.ts -
Import into Postman or Insomnia for manual testing, or a ready-made request collection.
-
Validate requests against the schema before sending.
-
Generate documentation for internal use.