Skip to main content

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​

CodeHTTPFamilyOriginating reference
K9O_ACCESS_DENIED403Authority / RBACSecurity §1.7
K9O_ALREADY_GROUP_MEMBER409Resource — conflictIdentity and projects
K9O_APPROVAL_DELEGATION_SCOPE_EXCEEDED403Authority / RBACControl §7
K9O_APPROVAL_DELEGATION_TRANSITIVE_PROHIBITED403Authority / RBACControl §7
K9O_APPROVAL_POLICY_NOT_MATCHED422Validation — semanticControl §7
K9O_APPROVAL_STALE_BASE409Resource — conflictControl §7
K9O_ATTESTATION_CHALLENGE_RATE_EXCEEDED429CapacitySKR
K9O_ATTESTATION_CHALLENGE_REPLAYED409Resource — conflictSKR
K9O_ATTESTATION_CHALLENGE_STALE403Authority / RBACSKR
K9O_ATTESTATION_MEASUREMENT_MISMATCH403Authority / RBACSKR
K9O_ATTESTATION_POLICY_NOT_SET409LifecycleSKR
K9O_ATTESTATION_QUOTE_VERIFICATION_FAILED403Authority / RBACSKR
K9O_ATTESTATION_TCB_TOO_OLD403Authority / RBACSKR
K9O_AUDIT_LOG_EXPORT_IN_PROGRESS409Resource — conflictSecurity §2.5
K9O_AUDIT_LOG_QUERY_WINDOW_TOO_LARGE400Validation — parse-timeSecurity §2.4
K9O_BILLING_EXPORT_NOT_READY425LifecycleBilling reference
K9O_BILLING_TIER_CHANGE_PROHIBITED403Authority / RBACBilling reference
K9O_BUCKET_NOT_FOUND404Resource — not foundData §9
K9O_BULK_APPROVAL_AUTHORITY_INSUFFICIENT403Authority / RBACControl §7
K9O_BYOK_KEY_PERMISSION_DENIED403Authority / RBACKibo
K9O_BYOK_KEY_UNREACHABLE503Service — unreachableKibo
K9O_BYOK_PROVIDER_NOT_SUPPORTED400Validation — parse-timeKibo
K9O_BYOK_REGION_MISMATCH409Validation — parse-timeKibo
K9O_CIRCULAR_REFERENCE_DETECTED400Validation — parse-timeData §3.7
K9O_COLLECTION_NOT_FOUND404Resource — not foundData §2.1
K9O_CONSTRAINT_VIOLATION409Resource — conflictData §10
K9O_CROSS_SHARD_TRANSACTION_UNSUPPORTED422LifecycleData §7.3
K9O_CUSTODY_MISMATCH409LifecycleKibo
K9O_CWIP_HAS_BOUND_WORKLOADS409Resource — conflictWorkload identities
K9O_CWIP_INVALID400Validation — parse-timeWorkload identities
K9O_CWIP_NOT_FOUND404Resource — not foundWorkload identities
K9O_DATASET_INVALID400Validation — parse-timePulse Lakehouse
K9O_DATASET_LIMIT_EXCEEDED429CapacityPulse Lakehouse
K9O_DATASET_NOT_FOUND404Resource — not foundPulse Lakehouse
K9O_DATASET_SCHEMA_CONFLICT409Resource — conflictPulse Lakehouse
K9O_DATASET_STORAGE_REGION_MISMATCH400Validation — parse-timePulse Lakehouse
K9O_DATASET_STORAGE_TARGET_INVALID400Validation — parse-timePulse Lakehouse
K9O_DEPROVISIONING_KEY_DISPOSITION_REQUIRED400Validation — parse-timeKibo
K9O_DISCOVERY_RATE_LIMITED429CapacityAuth — Discovery
K9O_EGRESS_QUOTA_EXCEEDED409CapacityBilling reference
K9O_EMAIL_ALREADY_REGISTERED409Resource — conflictGate
K9O_END_USER_NOT_FOUND404Resource — not foundGate
K9O_EXPORT_NOT_SUPPORTED_FOR_MODE400Validation — parse-timeKibo
K9O_EXTENSION_ALREADY_ENABLED409Resource — conflictExtensions
K9O_EXTENSION_ALREADY_REGISTERED409Resource — conflictExtensions
K9O_EXTENSION_HOOK_DELIVERY_FAILED502Service — bad gatewayExtensions
K9O_EXTENSION_HOOK_TIMEOUT504Service — timeoutExtensions
K9O_EXTENSION_MANIFEST_INVALID400Validation — parse-timeExtensions
K9O_EXTENSION_NOT_ENABLED404Resource — not foundExtensions
K9O_EXTENSION_NOT_FOUND404Resource — not foundExtensions
K9O_EXTENSION_PERMISSION_DENIED403Authority / RBACExtensions
K9O_EXTENSION_PURGE_GATE_REQUIRED403LifecycleExtensions
K9O_EXTENSION_REAUTHORISATION_REQUIRED409Resource — conflictExtensions
K9O_EXTENSION_SLUG_INVALID400Validation — parse-timeExtensions
K9O_EXTENSION_SLUG_RESERVED403AuthorityExtensions
K9O_EXTENSION_TIER_NOT_AVAILABLE400Validation — parse-timeExtensions
K9O_EXTENSION_UNREGISTERED409Resource — conflictExtensions
K9O_EXTENSION_VERSION_DOWNGRADE400Validation — parse-timeExtensions
K9O_FUNCTION_DEPLOYMENT_FAILED422Validation — semanticCompute §2.2
K9O_FUNCTION_MEMORY_EXCEEDED503Service — unreachableCompute §4.4
K9O_FUNCTION_NOT_FOUND404Resource — not foundCompute §2.2
K9O_FUNCTION_NOT_READY409Resource — conflictCompute §2.2
K9O_FUNCTION_RUNTIME_ERROR422Validation — semanticCompute §4.4
K9O_FUNCTION_TIMEOUT504Service — timeoutCompute §4.4
K9O_GATE_ACTION_SCOPE_MISMATCH400Validation — semanticControl §6.6
K9O_GATE_ALREADY_REDEEMED409Resource — conflictControl §6.5
K9O_GATE_CONSTRAINT_VIOLATION422Validation — semanticControl §6.4
K9O_GATE_NOT_FOUND404Resource — not foundControl §6.5
K9O_GATE_REJECTED422Validation — semanticControl §6.5
K9O_GATE_REQUIRED403Authority / RBACControl §6.5
K9O_GATE_TOKEN_EXPIRED422Validation — semanticControl §6.5
K9O_GATE_TOKEN_INVALID422Validation — semanticControl §6.5
K9O_GROUP_IN_USE409Resource — conflictIdentity and projects
K9O_GROUP_NAME_TAKEN409Resource — conflictIdentity and projects
K9O_GROUP_NOT_FOUND404Resource — not foundIdentity and projects
K9O_HYOK_CLUSTER_IN_USE409Resource — conflictKibo
K9O_HYOK_CLUSTER_NOT_FOUND404Resource — not foundKibo
K9O_HYOK_CLUSTER_UNKNOWN_HOST400Validation — parse-timeKibo
K9O_HYOK_CLUSTER_UNREACHABLE503Service — unreachableKibo
K9O_HYOK_HOST_IN_CLUSTER409Resource — conflictKibo
K9O_HYOK_HOST_NOT_FOUND404Resource — not foundKibo
K9O_HYOK_HOST_UNREACHABLE503Service — unreachableKibo
K9O_HYOK_KMIP_CIPHER_NOT_AEAD400Validation — parse-timeKibo
K9O_HYOK_KMIP_KEY_NOT_FOUND422Validation — semanticKibo
K9O_HYOK_KMIP_OPERATION_REJECTED502Service — bad gatewayKibo
K9O_HYOK_REGION_MISMATCH400Validation — parse-timeKibo
K9O_IDENTITY_PROVIDER_BIND_FAILED400Validation — parse-timeAuth
K9O_IDENTITY_PROVIDER_CREDENTIAL_REJECTED400Validation — parse-timeAuth
K9O_IDENTITY_PROVIDER_DISCOVERY_FAILED400Validation — parse-timeAuth
K9O_IDENTITY_PROVIDER_UNREACHABLE503Service — unreachableAuth
K9O_IDP_FEDERATION_FAILED502Service — bad gatewayGate
K9O_INJECTION_DETECTED400Validation — parse-timeThreat model §1–3
K9O_INVALID_API_VERSION400Validation — parse-timeConventions §1
K9O_INVALID_BASE_URL—Validation — parse-time (SDK construct-time)Per-language SDK shape
K9O_INVALID_CREDENTIALS401AuthGate
K9O_INVALID_FILTER400Validation — parse-timeData §8.2
K9O_INVALID_MIGRATION_FILE400Validation — parse-timeData §2.2
K9O_INVALID_VECTOR_DIMENSION400Validation — parse-timeData §5
K9O_INVITATION_EXPIRED410Auth — token expiryGate
K9O_KEY_ALREADY_REVOKED409Resource — conflictKibo
K9O_KEY_NOT_FOUND404Resource — not foundKibo
K9O_KEY_NOT_ROTATABLE409Resource — conflictKibo
K9O_KEY_ROTATION_IN_PROGRESS409Resource — conflictKibo
K9O_LEDGER_VERIFICATION_FAILED422Validation — semanticKibo
K9O_MAGIC_LINK_EXPIRED410Auth — token expiryGate
K9O_MALWARE_DETECTED422Validation — semanticData §9.3
K9O_MEASUREMENT_POLICY_ATTESTATION_REQUIRED403Authority / RBACSKR
K9O_MEASUREMENT_POLICY_INVALID400Validation — parse-timeSKR
K9O_MEASUREMENT_POLICY_UNAVAILABLE503Service — unreachableSKR
K9O_MEASUREMENT_POLICY_UPDATE_REQUIRES_GATE403Authority / RBACSKR
K9O_METADATA_FIELD_NOT_INDEXED400Validation — parse-timeData §11
K9O_MFA_REQUIRED401AuthGate
K9O_MFA_VERIFICATION_FAILED401AuthGate
K9O_MIGRATION_CONFLICT409Resource — conflictData §2.4
K9O_MIGRATION_POLICY_VALIDATION_FAILED400Validation — parse-timeData §2.2
K9O_MISSING_API_VERSION400Validation — parse-timeConventions §1
K9O_MISSING_ATTESTATION400Validation — parse-timeSKR
K9O_MULTIPLE_ROWS_RETURNED409Resource — conflictData §3.4
K9O_OBJECT_NOT_FOUND404Resource — not foundData §9
K9O_OBJECT_TOO_LARGE413Validation — parse-timeData §9
K9O_ORG_NOT_FOUND404Resource — not foundSlug addressing
K9O_OTP_EXPIRED410Auth — token expiryGate
K9O_PASSKEY_NOT_REGISTERED404Resource — not foundGate
K9O_PASSWORD_RESET_TOKEN_EXPIRED410Auth — token expiryGate
K9O_PII_JOIN_AUTHORITY_INSUFFICIENT403Authority / RBACGate
K9O_POLICY_AUTHORING_AUTHORITY_INSUFFICIENT403Authority / RBACControl §7
K9O_POLICY_BUNDLE_INVALID422Validation — semanticControl §3.2
K9O_POLICY_NESTING_TOO_DEEP400Validation — parse-timeControl §2
K9O_POLICY_NOT_FOUND404Resource — not foundControl §7
K9O_POLICY_PUBLISH_CONFLICT409Resource — conflictControl §7
K9O_POLICY_UNKNOWN_CONTEXT_FIELD400Validation — parse-timeControl §2
K9O_POLICY_UNKNOWN_OPERATOR400Validation — parse-timeControl §2.4
K9O_PROJECT_SOFT_DELETED409LifecycleIdentity and projects
K9O_PULSE_STREAM_ORG_QUOTA_EXCEEDED409CapacityPulse Stream
K9O_QUERY_RESULT_TOO_LARGE413Validation — parse-timeData §11
K9O_SERIALIZATION_FAILURE409Resource — conflictData §7.2
K9O_SESSION_EXPIRED401AuthGate
K9O_SIEM_NOT_CONFIGURED404Resource — not foundSecurity §2.6
K9O_SIEM_WEBHOOK_AUTH_FAILED401AuthSecurity §2.6
K9O_SIEM_WEBHOOK_UNREACHABLE503Service — unreachableSecurity §2.6
K9O_SLUG_GONE410Resource — goneSlug addressing
K9O_SLUG_INVALID_FORMAT400Validation — parse-timeSlug addressing
K9O_SLUG_RESERVED400Validation — parse-timeSlug addressing
K9O_SLUG_TAKEN409Resource — conflictSlug addressing
K9O_STORAGE_QUOTA_EXCEEDED409CapacityBilling reference
K9O_STREAM_INVALID400Validation — parse-timePulse Stream
K9O_STREAM_LIMIT_EXCEEDED429CapacityPulse Stream
K9O_STREAM_NOT_FOUND404Resource — not foundPulse Stream
K9O_STREAM_UNAVAILABLE503Service — unreachablePulse Stream
K9O_SUBSCRIPTION_LIMIT_EXCEEDED429CapacityData §8.6
K9O_TIER_CAP_HIT409CapacityBilling reference §9
K9O_TIER_RATE_LIMIT_EXCEEDED429CapacityBilling reference §9.2
K9O_TRANSACTION_TIMEOUT409Resource — conflictData §7.4
K9O_TRIGGER_LOOP_DETECTED— (logged)Service — runtimeCompute §3.2
K9O_UNKNOWN_SURFACE400Validation — parse-timeData §11
K9O_VAULT_OP_QUOTA_EXCEEDED409CapacityBilling reference
K9O_VECTOR_SUBJECT_ATTRIBUTION_REQUIRED400Validation — parse-timeData §5
K9O_WEAK_PASSWORD400Validation — parse-timeGate
K9O_WEBHOOK_SIGNATURE_INVALID401AuthSecurity → Webhook signature verification
K9O_WORKLOAD_BOUND_KEY_INVALID400Validation — parse-timeWorkload identities
K9O_WORKLOAD_BOUND_KEY_REQUIRED400Validation — parse-timeWorkload identities
K9O_WORKLOAD_FEDERATION_AUD_MISMATCH401AuthWorkload identities
K9O_WORKLOAD_FEDERATION_CLAIM_MATCHERS_REQUIRED400Validation — parse-timeWorkload identities
K9O_WORKLOAD_FEDERATION_CLAIM_MISMATCH403Authority / RBACWorkload identities
K9O_WORKLOAD_FEDERATION_ISSUER_UNREACHABLE503Service — unreachableWorkload identities
K9O_WORKLOAD_FEDERATION_ISS_MISMATCH401AuthWorkload identities
K9O_WORKLOAD_FEDERATION_TOKEN_INVALID401AuthWorkload identities
K9O_WORKLOAD_LIMIT_EXCEEDED429CapacityWorkload identities
K9O_WORKLOAD_MEASUREMENT_POLICY_REQUIRED400Validation — parse-timeWorkload identities
K9O_WORKLOAD_NOT_FOUND404Resource — not foundWorkload identities
K9O_WORKLOAD_VARIANT_MISMATCH400Validation — parse-timeWorkload identities

1.1 K9O_WEBHOOK_SIGNATURE_INVALID context payload​

The context field on K9O_WEBHOOK_SIGNATURE_INVALID carries scheme-specific failure detail:

FieldTypeDescription
context.schemestringOne 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.reasonstringScheme-specific failure reason (see below)
context.request_idstringRequest ID for correlation with the project's audit log

Scheme-specific context.reason values:

Scheme familyReason values
atlassian-jwtmismatch (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)
customReason 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.

CodeFamilyOriginating referenceDescription
captchaRequiredCapacityAuth — DiscoveryAnonymous-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_DOWNGRADEDPaginationConventions §6Server downgraded the requested count mode (e.g., exact → estimated due to runtime cost)
K9O_DEPRECATED_SURFACEVersioningConventionsCaller used a deprecated SDK surface; the recommendation cites the replacement
K9O_OFFSET_PAGINATION_INEFFICIENTPaginationData §3.3Caller is using .range() for pagination on a large collection; cursor-based pagination is recommended
K9O_POLICY_NOT_COUPLEDPolicyData §2.2Schema-only migration without an accompanying policy section
query_limit_clampedPaginationAuth — DiscoveryCaller-requested limit clamped to per-endpoint maximum; result correctness is unaffected; adjust the request limit if needed
result_count_cappedPaginationAuth — DiscoveryResponse set truncated at platform-imposed maximum; meta.totalCount reflects the cap value; refine the query or accept the cap
K9O_TEXT_SEARCH_NO_INDEXIndexData §4Full-text query executed without a GIN index
K9O_VECTOR_SEARCH_NO_INDEXIndexData §5Vector 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 KError wire shape (code, message, context, recommendation).