> ## Documentation Index
> Fetch the complete documentation index at: https://kavenio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limits

Kavenio validates request shape and platform limits before calling provider APIs
where practical. Provider rate limits still apply to provider-backed operations,
including posting, media publishing, ads actions, analytics, reviews, and
account discovery.

When a provider or Kavenio limit blocks a request, the API returns the standard
error envelope with a status and code that match the failure. Retry only when
the operation is idempotent or when the endpoint documentation explicitly
describes a retry path.

Use `Idempotency-Key` on mutation endpoints that document idempotent behavior,
especially ad creation and other actions where duplicate provider calls would be
expensive or customer-visible.