Errors

Endpoint

This page defines the endpoint, authentication, request schema, response schema, errors, rate limits, idempotency behavior, and related webhook events for errors.

Authentication

Use a server-side Kadryn API key.

Authorization: Bearer $KADRYN_API_KEY

Headers

• Content-Type: application/json
• Idempotency-Key for retry-safe writes.
• x-kadryn-project for project-level attribution.
• x-kadryn-feature for feature-level attribution.
• traceparent for distributed tracing.

Response

Successful responses return structured JSON and request correlation headers when applicable.

Errors

Handle 400, 401, 403, 409, 429, and retryable 5xx responses explicitly.