# Katalo API

> Katalo turns real-estate property photos into photorealistic, listing-ready staged images. These docs cover the server-to-server API for embedding Katalo into listing, CRM, marketplace, and batch workflows.

## Docs

- [API keys](https://docs.katalo.ai/docs/api/api-keys.md): Create, store, rotate, and revoke the organization-scoped credential used by every protected endpoint.
- [Errors](https://docs.katalo.ai/docs/api/errors.md): HTTP status codes, normalized error payloads, and practical retry guidance.
- [Generations](https://docs.katalo.ai/docs/api/generations.md): Create jobs, read job state, and regenerate from the same source asset using Katalo's workflow model.
- [OpenAPI reference](https://docs.katalo.ai/docs/api/openapi.md): Use the canonical machine-readable API contract.
- [Public API overview](https://docs.katalo.ai/docs/api/overview.md): What Katalo does and how the public API is structured: virtual staging, auth, job lifecycle, delivery, and operations.
- [Reliability](https://docs.katalo.ai/docs/api/reliability.md): Operational rules for idempotency, rate limits, retries, concurrency, and short-lived output URLs.
- [Usage & billing](https://docs.katalo.ai/docs/api/usage-billing.md): Read-only endpoints for entitlement checks, billing-period usage totals, and the API billing ledger.
- [Webhooks](https://docs.katalo.ai/docs/api/webhooks.md): Receive signed completion events on your backend and use polling only for fallback or recovery.

## OpenAPI Specs

- [external-api-v1.openapi](https://docs.katalo.ai/docs/external-api-v1.openapi.yaml)