Error catalogue
The closed-taxonomy lookup of every coined error code and warning code. Codes are alphabetised. The family taxonomy, HTTP status conventions, lifecycle rules, and warning-vs-error distinction live at /api/errors. The KError wire shape is bound in conventions §2; each code's per-instance context schema and recommendation shape are documented in the originating reference page.
1. Master error catalogue
| Code | HTTP | Family | Originating reference |
|---|---|---|---|
K9O_ACCESS_DENIED | 403 | Authority / RBAC | Security §1.7 |
K9O_ALREADY_GROUP_MEMBER | 409 | Resource — conflict | Identity and projects |
K9O_APPROVAL_DELEGATION_SCOPE_EXCEEDED | 403 | Authority / RBAC | Control §7 |
K9O_APPROVAL_DELEGATION_TRANSITIVE_PROHIBITED | 403 | Authority / RBAC | Control §7 |
K9O_APPROVAL_POLICY_NOT_MATCHED | 422 | Validation — semantic | Control §7 |
K9O_APPROVAL_STALE_BASE | 409 | Resource — conflict | Control §7 |
K9O_ATTESTATION_CHALLENGE_RATE_EXCEEDED | 429 | Capacity | SKR |
K9O_ATTESTATION_CHALLENGE_REPLAYED | 409 | Resource — conflict | SKR |
K9O_ATTESTATION_CHALLENGE_STALE | 403 | Authority / RBAC | SKR |
K9O_ATTESTATION_MEASUREMENT_MISMATCH | 403 | Authority / RBAC | SKR |
K9O_ATTESTATION_POLICY_NOT_SET | 409 | Lifecycle | SKR |
K9O_ATTESTATION_QUOTE_VERIFICATION_FAILED | 403 | Authority / RBAC | SKR |
K9O_ATTESTATION_TCB_TOO_OLD | 403 | Authority / RBAC | SKR |
K9O_AUDIT_LOG_EXPORT_IN_PROGRESS | 409 | Resource — conflict | Security §2.5 |
K9O_AUDIT_LOG_QUERY_WINDOW_TOO_LARGE | 400 | Validation — parse-time | Security §2.4 |
K9O_BILLING_EXPORT_NOT_READY | 425 | Lifecycle | Billing reference |
K9O_BILLING_TIER_CHANGE_PROHIBITED | 403 | Authority / RBAC | Billing reference |
K9O_BUCKET_NOT_FOUND | 404 | Resource — not found | Data §9 |
K9O_BULK_APPROVAL_AUTHORITY_INSUFFICIENT | 403 | Authority / RBAC | Control §7 |
K9O_BYOK_KEY_PERMISSION_DENIED | 403 | Authority / RBAC | Kibo |
K9O_BYOK_KEY_UNREACHABLE | 503 | Service — unreachable | Kibo |
K9O_BYOK_PROVIDER_NOT_SUPPORTED | 400 | Validation — parse-time | Kibo |
K9O_BYOK_REGION_MISMATCH | 409 | Validation — parse-time | Kibo |
K9O_CIRCULAR_REFERENCE_DETECTED | 400 | Validation — parse-time | Data §3.7 |
K9O_COLLECTION_NOT_FOUND | 404 | Resource — not found | Data §2.1 |
K9O_CONSTRAINT_VIOLATION | 409 | Resource — conflict | Data §10 |
K9O_CROSS_SHARD_TRANSACTION_UNSUPPORTED | 422 | Lifecycle | Data §7.3 |
K9O_CUSTODY_MISMATCH | 409 | Lifecycle | Kibo |
K9O_CWIP_HAS_BOUND_WORKLOADS | 409 | Resource — conflict | Workload identities |
K9O_CWIP_INVALID | 400 | Validation — parse-time | Workload identities |
K9O_CWIP_NOT_FOUND | 404 | Resource — not found | Workload identities |
K9O_DATASET_INVALID | 400 | Validation — parse-time | Pulse Lakehouse |
K9O_DATASET_LIMIT_EXCEEDED | 429 | Capacity | Pulse Lakehouse |
K9O_DATASET_NOT_FOUND | 404 | Resource — not found | Pulse Lakehouse |
K9O_DATASET_SCHEMA_CONFLICT | 409 | Resource — conflict | Pulse Lakehouse |
K9O_DATASET_STORAGE_REGION_MISMATCH | 400 | Validation — parse-time | Pulse Lakehouse |
K9O_DATASET_STORAGE_TARGET_INVALID | 400 | Validation — parse-time | Pulse Lakehouse |
K9O_DEPROVISIONING_KEY_DISPOSITION_REQUIRED | 400 | Validation — parse-time | Kibo |
K9O_DISCOVERY_RATE_LIMITED | 429 | Capacity | Auth — Discovery |
K9O_EGRESS_QUOTA_EXCEEDED | 409 | Capacity | Billing reference |
K9O_EMAIL_ALREADY_REGISTERED | 409 | Resource — conflict | Gate |
K9O_END_USER_NOT_FOUND | 404 | Resource — not found | Gate |
K9O_EXPORT_NOT_SUPPORTED_FOR_MODE | 400 | Validation — parse-time | Kibo |
K9O_EXTENSION_ALREADY_ENABLED | 409 | Resource — conflict | Extensions |
K9O_EXTENSION_ALREADY_REGISTERED | 409 | Resource — conflict | Extensions |
K9O_EXTENSION_HOOK_DELIVERY_FAILED | 502 | Service — bad gateway | Extensions |
K9O_EXTENSION_HOOK_TIMEOUT | 504 | Service — timeout | Extensions |
K9O_EXTENSION_MANIFEST_INVALID | 400 | Validation — parse-time | Extensions |
K9O_EXTENSION_NOT_ENABLED | 404 | Resource — not found | Extensions |
K9O_EXTENSION_NOT_FOUND | 404 | Resource — not found | Extensions |
K9O_EXTENSION_PERMISSION_DENIED | 403 | Authority / RBAC | Extensions |
K9O_EXTENSION_PURGE_GATE_REQUIRED | 403 | Lifecycle | Extensions |
K9O_EXTENSION_REAUTHORISATION_REQUIRED | 409 | Resource — conflict | Extensions |
K9O_EXTENSION_SLUG_INVALID | 400 | Validation — parse-time | Extensions |
K9O_EXTENSION_SLUG_RESERVED | 403 | Authority | Extensions |
K9O_EXTENSION_TIER_NOT_AVAILABLE | 400 | Validation — parse-time | Extensions |
K9O_EXTENSION_UNREGISTERED | 409 | Resource — conflict | Extensions |
K9O_EXTENSION_VERSION_DOWNGRADE | 400 | Validation — parse-time | Extensions |
K9O_FUNCTION_DEPLOYMENT_FAILED | 422 | Validation — semantic | Compute §2.2 |
K9O_FUNCTION_MEMORY_EXCEEDED | 503 | Service — unreachable | Compute §4.4 |
K9O_FUNCTION_NOT_FOUND | 404 | Resource — not found | Compute §2.2 |
K9O_FUNCTION_NOT_READY | 409 | Resource — conflict | Compute §2.2 |
K9O_FUNCTION_RUNTIME_ERROR | 422 | Validation — semantic | Compute §4.4 |
K9O_FUNCTION_TIMEOUT | 504 | Service — timeout | Compute §4.4 |
K9O_GATE_ACTION_SCOPE_MISMATCH | 400 | Validation — semantic | Control §6.6 |
K9O_GATE_ALREADY_REDEEMED | 409 | Resource — conflict | Control §6.5 |
K9O_GATE_CONSTRAINT_VIOLATION | 422 | Validation — semantic | Control §6.4 |
K9O_GATE_NOT_FOUND | 404 | Resource — not found | Control §6.5 |
K9O_GATE_REJECTED | 422 | Validation — semantic | Control §6.5 |
K9O_GATE_REQUIRED | 403 | Authority / RBAC | Control §6.5 |
K9O_GATE_TOKEN_EXPIRED | 422 | Validation — semantic | Control §6.5 |
K9O_GATE_TOKEN_INVALID | 422 | Validation — semantic | Control §6.5 |
K9O_GROUP_IN_USE | 409 | Resource — conflict | Identity and projects |
K9O_GROUP_NAME_TAKEN | 409 | Resource — conflict | Identity and projects |
K9O_GROUP_NOT_FOUND | 404 | Resource — not found | Identity and projects |
K9O_HYOK_CLUSTER_IN_USE | 409 | Resource — conflict | Kibo |
K9O_HYOK_CLUSTER_NOT_FOUND | 404 | Resource — not found | Kibo |
K9O_HYOK_CLUSTER_UNKNOWN_HOST | 400 | Validation — parse-time | Kibo |
K9O_HYOK_CLUSTER_UNREACHABLE | 503 | Service — unreachable | Kibo |
K9O_HYOK_HOST_IN_CLUSTER | 409 | Resource — conflict | Kibo |
K9O_HYOK_HOST_NOT_FOUND | 404 | Resource — not found | Kibo |
K9O_HYOK_HOST_UNREACHABLE | 503 | Service — unreachable | Kibo |
K9O_HYOK_KMIP_CIPHER_NOT_AEAD | 400 | Validation — parse-time | Kibo |
K9O_HYOK_KMIP_KEY_NOT_FOUND | 422 | Validation — semantic | Kibo |
K9O_HYOK_KMIP_OPERATION_REJECTED | 502 | Service — bad gateway | Kibo |
K9O_HYOK_REGION_MISMATCH | 400 | Validation — parse-time | Kibo |
K9O_IDENTITY_PROVIDER_BIND_FAILED | 400 | Validation — parse-time | Auth |
K9O_IDENTITY_PROVIDER_CREDENTIAL_REJECTED | 400 | Validation — parse-time | Auth |
K9O_IDENTITY_PROVIDER_DISCOVERY_FAILED | 400 | Validation — parse-time | Auth |
K9O_IDENTITY_PROVIDER_UNREACHABLE | 503 | Service — unreachable | Auth |
K9O_IDP_FEDERATION_FAILED | 502 | Service — bad gateway | Gate |
K9O_INJECTION_DETECTED | 400 | Validation — parse-time | Threat model §1–3 |
K9O_INVALID_API_VERSION | 400 | Validation — parse-time | Conventions §1 |
K9O_INVALID_BASE_URL | — | Validation — parse-time (SDK construct-time) | Per-language SDK shape |
K9O_INVALID_CREDENTIALS | 401 | Auth | Gate |
K9O_INVALID_FILTER | 400 | Validation — parse-time | Data §8.2 |
K9O_INVALID_MIGRATION_FILE | 400 | Validation — parse-time | Data §2.2 |
K9O_INVALID_VECTOR_DIMENSION | 400 | Validation — parse-time | Data §5 |
K9O_INVITATION_EXPIRED | 410 | Auth — token expiry | Gate |
K9O_KEY_ALREADY_REVOKED | 409 | Resource — conflict | Kibo |
K9O_KEY_NOT_FOUND | 404 | Resource — not found | Kibo |
K9O_KEY_NOT_ROTATABLE | 409 | Resource — conflict | Kibo |
K9O_KEY_ROTATION_IN_PROGRESS | 409 | Resource — conflict | Kibo |
K9O_LEDGER_VERIFICATION_FAILED | 422 | Validation — semantic | Kibo |
K9O_MAGIC_LINK_EXPIRED | 410 | Auth — token expiry | Gate |
K9O_MALWARE_DETECTED | 422 | Validation — semantic | Data §9.3 |
K9O_MEASUREMENT_POLICY_ATTESTATION_REQUIRED | 403 | Authority / RBAC | SKR |
K9O_MEASUREMENT_POLICY_INVALID | 400 | Validation — parse-time | SKR |
K9O_MEASUREMENT_POLICY_UNAVAILABLE | 503 | Service — unreachable | SKR |
K9O_MEASUREMENT_POLICY_UPDATE_REQUIRES_GATE | 403 | Authority / RBAC | SKR |
K9O_METADATA_FIELD_NOT_INDEXED | 400 | Validation — parse-time | Data §11 |
K9O_MFA_REQUIRED | 401 | Auth | Gate |
K9O_MFA_VERIFICATION_FAILED | 401 | Auth | Gate |
K9O_MIGRATION_CONFLICT | 409 | Resource — conflict | Data §2.4 |
K9O_MIGRATION_POLICY_VALIDATION_FAILED | 400 | Validation — parse-time | Data §2.2 |
K9O_MISSING_API_VERSION | 400 | Validation — parse-time | Conventions §1 |
K9O_MISSING_ATTESTATION | 400 | Validation — parse-time | SKR |
K9O_MULTIPLE_ROWS_RETURNED | 409 | Resource — conflict | Data §3.4 |
K9O_OBJECT_NOT_FOUND | 404 | Resource — not found | Data §9 |
K9O_OBJECT_TOO_LARGE | 413 | Validation — parse-time | Data §9 |
K9O_ORG_NOT_FOUND | 404 | Resource — not found | Slug addressing |
K9O_OTP_EXPIRED | 410 | Auth — token expiry | Gate |
K9O_PASSKEY_NOT_REGISTERED | 404 | Resource — not found | Gate |
K9O_PASSWORD_RESET_TOKEN_EXPIRED | 410 | Auth — token expiry | Gate |
K9O_PII_JOIN_AUTHORITY_INSUFFICIENT | 403 | Authority / RBAC | Gate |
K9O_POLICY_AUTHORING_AUTHORITY_INSUFFICIENT | 403 | Authority / RBAC | Control §7 |
K9O_POLICY_BUNDLE_INVALID | 422 | Validation — semantic | Control §3.2 |
K9O_POLICY_NESTING_TOO_DEEP | 400 | Validation — parse-time | Control §2 |
K9O_POLICY_NOT_FOUND | 404 | Resource — not found | Control §7 |
K9O_POLICY_PUBLISH_CONFLICT | 409 | Resource — conflict | Control §7 |
K9O_POLICY_UNKNOWN_CONTEXT_FIELD | 400 | Validation — parse-time | Control §2 |
K9O_POLICY_UNKNOWN_OPERATOR | 400 | Validation — parse-time | Control §2.4 |
K9O_PROJECT_SOFT_DELETED | 409 | Lifecycle | Identity and projects |
K9O_PULSE_STREAM_ORG_QUOTA_EXCEEDED | 409 | Capacity | Pulse Stream |
K9O_QUERY_RESULT_TOO_LARGE | 413 | Validation — parse-time | Data §11 |
K9O_SERIALIZATION_FAILURE | 409 | Resource — conflict | Data §7.2 |
K9O_SESSION_EXPIRED | 401 | Auth | Gate |
K9O_SIEM_NOT_CONFIGURED | 404 | Resource — not found | Security §2.6 |
K9O_SIEM_WEBHOOK_AUTH_FAILED | 401 | Auth | Security §2.6 |
K9O_SIEM_WEBHOOK_UNREACHABLE | 503 | Service — unreachable | Security §2.6 |
K9O_SLUG_GONE | 410 | Resource — gone | Slug addressing |
K9O_SLUG_INVALID_FORMAT | 400 | Validation — parse-time | Slug addressing |
K9O_SLUG_RESERVED | 400 | Validation — parse-time | Slug addressing |
K9O_SLUG_TAKEN | 409 | Resource — conflict | Slug addressing |
K9O_STORAGE_QUOTA_EXCEEDED | 409 | Capacity | Billing reference |
K9O_STREAM_INVALID | 400 | Validation — parse-time | Pulse Stream |
K9O_STREAM_LIMIT_EXCEEDED | 429 | Capacity | Pulse Stream |
K9O_STREAM_NOT_FOUND | 404 | Resource — not found | Pulse Stream |
K9O_STREAM_UNAVAILABLE | 503 | Service — unreachable | Pulse Stream |
K9O_SUBSCRIPTION_LIMIT_EXCEEDED | 429 | Capacity | Data §8.6 |
K9O_TIER_CAP_HIT | 409 | Capacity | Billing reference §9 |
K9O_TIER_RATE_LIMIT_EXCEEDED | 429 | Capacity | Billing reference §9.2 |
K9O_TRANSACTION_TIMEOUT | 409 | Resource — conflict | Data §7.4 |
K9O_TRIGGER_LOOP_DETECTED | — (logged) | Service — runtime | Compute §3.2 |
K9O_UNKNOWN_SURFACE | 400 | Validation — parse-time | Data §11 |
K9O_VAULT_OP_QUOTA_EXCEEDED | 409 | Capacity | Billing reference |
K9O_VECTOR_SUBJECT_ATTRIBUTION_REQUIRED | 400 | Validation — parse-time | Data §5 |
K9O_WEAK_PASSWORD | 400 | Validation — parse-time | Gate |
K9O_WEBHOOK_SIGNATURE_INVALID | 401 | Auth | Security → Webhook signature verification |
K9O_WORKLOAD_BOUND_KEY_INVALID | 400 | Validation — parse-time | Workload identities |
K9O_WORKLOAD_BOUND_KEY_REQUIRED | 400 | Validation — parse-time | Workload identities |
K9O_WORKLOAD_FEDERATION_AUD_MISMATCH | 401 | Auth | Workload identities |
K9O_WORKLOAD_FEDERATION_CLAIM_MATCHERS_REQUIRED | 400 | Validation — parse-time | Workload identities |
K9O_WORKLOAD_FEDERATION_CLAIM_MISMATCH | 403 | Authority / RBAC | Workload identities |
K9O_WORKLOAD_FEDERATION_ISSUER_UNREACHABLE | 503 | Service — unreachable | Workload identities |
K9O_WORKLOAD_FEDERATION_ISS_MISMATCH | 401 | Auth | Workload identities |
K9O_WORKLOAD_FEDERATION_TOKEN_INVALID | 401 | Auth | Workload identities |
K9O_WORKLOAD_LIMIT_EXCEEDED | 429 | Capacity | Workload identities |
K9O_WORKLOAD_MEASUREMENT_POLICY_REQUIRED | 400 | Validation — parse-time | Workload identities |
K9O_WORKLOAD_NOT_FOUND | 404 | Resource — not found | Workload identities |
K9O_WORKLOAD_VARIANT_MISMATCH | 400 | Validation — parse-time | Workload identities |
1.1 K9O_WEBHOOK_SIGNATURE_INVALID context payload
The context field on K9O_WEBHOOK_SIGNATURE_INVALID carries scheme-specific failure detail:
| Field | Type | Description |
|---|---|---|
context.scheme | string | One of 12 standard scheme values — stripe-v1, github-hmac-sha256, slack-v0, sendgrid-v3-ed25519, twilio, shopify, linear, notion, discord, ms-teams, generic-hmac-sha256, atlassian-jwt — or custom for extensions on the escape-hatch path |
context.reason | string | Scheme-specific failure reason (see below) |
context.request_id | string | Request ID for correlation with the project's audit log |
Scheme-specific context.reason values:
| Scheme family | Reason values |
|---|---|
atlassian-jwt | mismatch (JWT signature failed), qsh_mismatch (query-string-hash claim does not match canonical request), expired (JWT past the 3-minute tolerance), iss_mismatch (issuer claim does not match the enrolled Atlassian app), unauthorized_app (issuer not associated with this extension installation) |
HMAC-family schemes (stripe-v1, github-hmac-sha256, slack-v0, shopify, linear, notion, ms-teams, generic-hmac-sha256, twilio) | mismatch (HMAC comparison failed), expired (request timestamp outside the accepted skew window where the scheme defines one), replay (request signature matches a recently-processed request — replay-protection trigger) |
Ed25519 schemes (sendgrid-v3-ed25519, discord) | mismatch (signature failed verification against the published public key), expired (timestamp outside the accepted skew window) |
custom | Reason value is extension-defined; the extension's custom verification code surfaces the reason through the gateway |
The error is returned to the third-party webhook sender, which typically retries with the vendor's standard backoff. The error also surfaces in the project's audit log with the calling source IP and the full context payload for forensic review.
2. Warning catalogue
Warnings ride the success-path meta.warnings envelope. Each warning is an array entry of shape { code, message } on a successful response (HTTP 2xx); they are NOT errors and do not throw KError.
| Code | Family | Originating reference | Description |
|---|---|---|---|
captchaRequired | Capacity | Auth — Discovery | Anonymous-surface sustained-abuse pattern triggered gateway-side CAPTCHA progressive challenge; next request must include X-Captcha-Token: <token> from platform-issued CAPTCHA flow |
K9O_COUNT_MODE_DOWNGRADED | Pagination | Conventions §6 | Server downgraded the requested count mode (e.g., exact → estimated due to runtime cost) |
K9O_DEPRECATED_SURFACE | Versioning | Conventions | Caller used a deprecated SDK surface; the recommendation cites the replacement |
K9O_OFFSET_PAGINATION_INEFFICIENT | Pagination | Data §3.3 | Caller is using .range() for pagination on a large collection; cursor-based pagination is recommended |
K9O_POLICY_NOT_COUPLED | Policy | Data §2.2 | Schema-only migration without an accompanying policy section |
query_limit_clamped | Pagination | Auth — Discovery | Caller-requested limit clamped to per-endpoint maximum; result correctness is unaffected; adjust the request limit if needed |
result_count_capped | Pagination | Auth — Discovery | Response set truncated at platform-imposed maximum; meta.totalCount reflects the cap value; refine the query or accept the cap |
K9O_TEXT_SEARCH_NO_INDEX | Index | Data §4 | Full-text query executed without a GIN index |
K9O_VECTOR_SEARCH_NO_INDEX | Index | Data §5 | Vector search executed without an ivfflat / hnsw index |
3. See also
/api/errors— the family taxonomy, HTTP status conventions per family, warning-vs-error distinction, and lifecycle rules.- Conventions §2 — the
KErrorwire shape (code,message,context,recommendation).