API and schema reference

The SDK provides convenient typed operations. The OpenAPI document and JSON Schemas describe the underlying contracts when you need request fields, response shapes, or another language client.

OpenAPI

• Live Developer API
• Committed OpenAPI 3.1 document

The current public contract is 2026-08-24. Use authentication to connect to protected endpoints and compatibility to understand version support.

JSON Schemas

Browse the generated schemas for task, run, event, approval, package, and related models.

When validating application output, start with structured outcomes. For retries, pagination, and decisions that depend on current state, use the SDK rather than treating a generated HTTP client as the complete execution model.

Working on Geyser Open

From a source checkout with its development dependencies installed, run make schemas to check that committed schemas match the SDK models. See the repository for contribution and build instructions.