Client Input
209 tutorials in this category.
4001
CHW-4001 BadRequest
request payload failed validation; see endpoint documentation for the expected shape
4002
CHW-4002 CoordinateInvalid
package coordinate could not be parsed; supply name, version, and (where required) namespace in the format the ecosystem expects
4101
CHW-4101 SignupValidation
signup payload failed validation; email, password, and org_name are required
4102
CHW-4102 EmailConflict
An account with this email already exists. Sign in instead.
4103
CHW-4103 InvalidPayload
request payload was missing or malformed; see endpoint documentation for the expected JSON shape
4104
CHW-4104 PasswordTooShort
password must be at least 12 characters
4105
CHW-4105 BusinessEmailRejected
signup requires a business email address; personal / disposable providers are not accepted
4106
CHW-4106 PasswordMismatch
new password and confirmation do not match
4107
CHW-4107 VerificationTokenInvalid
invalid or expired verification link
4108
CHW-4108 VerificationTokenExpired
this verification link has expired; please request a new one
4109
CHW-4109 VerificationTokenUsed
this verification link has already been used
4110
CHW-4110 ResetTokenInvalid
invalid or expired reset link
4111
CHW-4111 ResetTokenExpired
this reset link has expired; please request a new one
4112
CHW-4112 ResetTokenUsed
this reset link has already been used
4113
CHW-4113 TOTPNotConfigured
no TOTP setup in progress; call /api/settings/2fa/setup first
4114
CHW-4114 TOTPAlreadyEnabled
two-factor authentication is already enabled; disable it before re-enrolling
4115
CHW-4115 TOTPSetupMissing
no TOTP setup in progress; start setup before verifying a code
4116
CHW-4116 SSOConfigInvalid
SSO configuration payload is missing required fields for the chosen protocol
4117
CHW-4117 SSONotConfigured
SSO is not configured for this organization
4118
CHW-4118 SSOGroupMappingConflict
a mapping for this group value already exists on this provider
4119
CHW-4119 SSOGroupMappingNotFound
SSO group mapping not found
4120
CHW-4120 MemberNotFound
member not found in your organization
4121
CHW-4121 TargetUserHasNoTOTP
this member does not have two-factor authentication enabled
4122
CHW-4122 FeatureDisabled
this feature is not enabled on this instance
4123
CHW-4123 EmailAliasExists
An account already exists for the underlying email address. Sign in or use a different email.
4124
CHW-4124 OrgSlugExists
A workspace with this name already exists. Try a different name.
4201
CHW-4201 OrgNotFound
organization not found; verify the org_id and that it has not been deleted
4202
CHW-4202 UserNotFound
user not found in this organization; verify the user_id and that the membership still exists
4203
CHW-4203 GroupNotFound
group not found in this organization; verify the group_id
4204
CHW-4204 RoleNotFound
role not found in this organization; verify the role slug or id
4205
CHW-4205 InvitationNotFound
invitation not found; verify the token or ask the inviter to re-issue
4206
CHW-4206 InvitationExpired
invitation has expired; ask the inviter to re-issue it
4207
CHW-4207 InvitationAlreadyAccepted
invitation has already been accepted; sign in with the invited email to access the org
4208
CHW-4208 OrgSlugConflict
org slug is already in use; pick a different slug
4209
CHW-4209 EmailAlreadyRegistered
this email is already registered; invite by inviting the existing account or ask them to sign in and accept
4210
CHW-4210 InvitePending
a pending invitation already exists for this email; revoke it before issuing a new one
4211
CHW-4211 AccountAlreadyExists
an account with this email already exists; sign in and then accept the invitation from the same session
4212
CHW-4212 MemberCapReached
member limit reached — ask an owner to upgrade the organization's plan
4213
CHW-4213 UnknownRole
unknown role; supply a built-in role slug or an existing custom role in this org
4214
CHW-4214 BuiltinRoleImmutable
built-in roles cannot be edited or deleted; create a custom role instead
4215
CHW-4215 RoleInUse
role is in use; reassign members, invitations, and SSO defaults before deleting
4216
CHW-4216 InvitationRoleUnavailable
the invitation's role is no longer available; ask the inviter to re-issue with a current role
4217
CHW-4217 InvalidEmail
email failed validation; use a business email address accepted by the org policy
4218
CHW-4218 WeakPassword
password must be at least 12 characters; supply a longer passphrase
4301
CHW-4301 PackageNotFound
package not found; verify the package id and that it has not been deleted
4302
CHW-4302 PackageVersionNotFound
package version not found; verify the version string and that it has not been deleted
4303
CHW-4303 PackagePermissionNotFound
package permission not found; verify the permission id and the caller's org
4304
CHW-4304 PackageSlugConflict
package slug already exists for this repository; pick a different package_name or update the existing slug
4305
CHW-4305 UpstreamPackageExists
package name already exists in the upstream registry; only names unused upstream can be registered as internal packages
4306
CHW-4306 RepositoryNotFound
repository not found; verify the repository name and that it is configured for this org
4307
CHW-4307 InvalidRepositoryPath
invalid repository path; use /repository/@{org-slug}/{repo}/{path} or /repository/{repo}/{path}
4308
CHW-4308 PackageIdentifierMissing
missing package or permission identifier in URL; supply /api/packages/{id} or /api/package-permissions/{id}
4309
CHW-4309 PackageFieldsRequired
required fields are missing from the request body; see endpoint documentation for the expected shape
4310
CHW-4310 PackagePermissionConflict
package permission already exists for this client, pattern, and repository; edit the existing row instead of creating a duplicate
4311
CHW-4311 ClientNotInOrg
client not found in this organization; verify the client_id or create the client credentials first
4312
CHW-4312 ExceptionNotFound
exception policy not found; verify the exception id and that it has not been deleted
4313
CHW-4313 ExceptionNotRenewable
only vulnerability-exception policies can be renewed; other policy types have no expiry to extend
4314
CHW-4314 OrgSlugRequired
org-scoped URL required: /repository/@{org-slug}/{repo-name}/...; legacy URLs without the org slug are disabled on this instance
4315
CHW-4315 FindingNotFound
finding not found; verify the id and that it belongs to the caller's org
4316
CHW-4316 FindingInvalidTransition
finding status transition not allowed; see the finding state machine documentation for the legal moves
4317
CHW-4317 IntelFeatureDisabled
scan subsystem not initialised on the server
4318
CHW-4318 IntelBadLockfile
lockfile could not be parsed; verify the base64 payload and the lockfileType
4319
CHW-4319 IntelBulkLimitExceeded
bulk request exceeds 500 items; split the request or lower maxResults
4320
CHW-4320 IntelUnsupportedLockfileType
unsupported lockfile type; valid values are "npm" and "pnpm"
4321
CHW-4321 SBOMFormatUnsupported
unsupported sbom output format; this server emits CycloneDX only (use ?format=cyclonedx or omit the parameter; for ecosystem filtering use ?ecosystem=npm)
4322
CHW-4322 RiskWeightsInvalidShape
risk weight override malformed; expected body {"weights":{"vulnerability":0.5,...}} with numeric values
4323
CHW-4323 RiskWeightsSumRejected
risk weight override fails validation: weights must be non-negative, known categories, sum > 0, and no single weight above 0.8
4324
CHW-4324 RiskWeightsNotFound
no risk weight override set for this org; defaults apply until a PUT /api/v1/intel/weights is made
4325
CHW-4325 TuningSuggestionNotFound
tuning suggestion not found; verify the id and that it belongs to the caller's org
4326
CHW-4326 TuningSuggestionNotOpen
tuning suggestion is not in the 'open' state; only open suggestions can be accepted or dismissed (the next action must come from a new posterior pass)
4327
CHW-4327 FindingFeedbackInvalidAction
feedback action must be one of: false_positive, true_positive, retract; retract requires a referencing_event_id
4401
CHW-4401 BillingPlanInvalid
plan_id is not one of the allowed plan slugs; supply a current plan from /api/billing/plans
4402
CHW-4402 BillingCycleInvalid
billing_cycle must be either "month" or "year"
4403
CHW-4403 BillingCycleNotAvailable
the selected plan is not available on the requested billing cycle; pick a different cycle or contact support
4404
CHW-4404 BillingBodyInvalid
billing request body was missing or malformed; see /api/billing documentation for the expected shape
4405
CHW-4405 BillyMessageRequired
Billy chat requires a non-empty message field
4406
CHW-4406 BillyActionUnsupported
unsupported Billy action type; supply one of the handler-registered action kinds
4407
CHW-4407 BillyPolicyInvalid
Billy policy payload was missing or malformed; supply a decodable policy draft
4408
CHW-4408 BillyActionTargetMissing
Billy action is missing its required target id or policy draft
4409
CHW-4409 BillyServiceTokenNotFound
service token not found in this organization; verify the client id
4410
CHW-4410 BillyServiceTokenWrongType
target client is not a service token; service_token.disable cannot apply to user-owned credentials
4411
CHW-4411 BillyPolicyNotFound
policy not found in this organization; verify the policy id
4412
CHW-4412 BillyPolicyStoreError
policy store rejected the draft; fix the validation issue and retry
4413
CHW-4413 BillyChatRateLimited
Billy chat rate limit exceeded — please wait and retry
4501
CHW-4501 UsagePlanInUse
cannot delete this pricing plan: it is still assigned to one or more organisations; reassign those orgs to a different plan first
4502
CHW-4502 UsagePlanDefaultConflict
another pricing plan is already marked as the default; clear the existing default before promoting a new one
4503
CHW-4503 PlanFeaturesInvalid
pricing plan features JSON failed validation; supply a JSON object whose keys match the documented feature flags
4504
CHW-4504 PlanAssignmentInvalid
plan assignment requires both orgId and planId in the request body
4505
CHW-4505 UsageUserIDRequired
user id segment is required on /api/usage/users/{userId}
4506
CHW-4506 AdminOrgIDRequired
org_id query parameter is required for this admin endpoint
4507
CHW-4507 TrafficViewNameRequired
saved traffic view requires a non-empty "name" field so it can be identified in the UI
4508
CHW-4508 TrafficViewIDRequired
view id segment is required on DELETE /api/traffic/views/{id}
4509
CHW-4509 ViolationIDInvalid
violation id segment must be a numeric value; check the URL
4510
CHW-4510 ViolationNotFound
violation not found in this organisation; verify the id and that the violation has not been purged
4511
CHW-4511 RepositoryRequired
repository name segment is required on this endpoint
4512
CHW-4512 VulnerabilitiesPathInvalid
vulnerabilities path must match {repository}/vulnerabilities; check the URL
4513
CHW-4513 AuditEventInvalid
audit event payload was missing required fields or could not be decoded; check the request body shape
4514
CHW-4514 ScanRequestInvalid
scan request body could not be decoded or contained an empty packages list; supply {"packages":[{"name":"...","version":"..."},...]}
4515
CHW-4515 AttestationInvalid
attestation payload was missing required fields (device_id, ecosystems, direct_registry_egress) or could not be decoded; check the request body shape
4516
CHW-4516 CoverageFlagInvalid
coverage flag payload requires a non-empty client_id; check the request body shape
4517
CHW-4517 BypassExemptionInvalid
bypass exemption payload requires a non-empty client_id and reason; check the request body shape
4518
CHW-4518 BypassExemptionResolveBlocked
this exemption cannot be resolved yet: bypass confidence has not stayed below threshold for the required 24h window
4519
CHW-4519 AuditExportTooLarge
audit export refused: this org has more rows than the in-memory export endpoint can safely return; use the (forthcoming) streaming /api/audit/export?cursor=… endpoint, or narrow the window with -…
4601
CHW-4601 SettingsValidation
settings payload failed validation; check field types and ranges against the endpoint documentation
4602
CHW-4602 SettingsNoChange
settings payload contained no mutable fields; supply at least one field to update
4603
CHW-4603 PolicyInvalid
policy payload failed validation; check rule shape, action, and scope against the policy schema
4604
CHW-4604 PolicyConflict
policy conflicts with an existing one (duplicate name or precedence); pick a unique identifier or precedence
4605
CHW-4605 PolicyNotFound
policy not found in this organisation
4606
CHW-4606 ProxyNotFound
proxy/repository not found in this organisation
4607
CHW-4607 ProxyInvalidConfig
proxy update payload failed validation; check remote_url, cache_negative_ttl_seconds, and that at least one mutable field is supplied
4608
CHW-4608 DataSourceUnknown
unknown data source; expected one of openssf, trivydb, epss, clamavdb
4609
CHW-4609 CachePathInvalid
cache purge path is malformed; expected /api/cache/repos/{repo}/packages/{package}/{version}
4610
CHW-4610 CacheArtifactsNotFound
no cached artifacts found for the supplied repository, package, and version
4611
CHW-4611 CachePurgePasswordRequired
cache purge-all requires a password in the request body
4612
CHW-4612 CachePurgePasswordInvalid
incorrect password
4613
CHW-4613 OnboardingClientNotFound
client not found in this organisation
4614
CHW-4614 OrgIDRequired
org_id is required for this endpoint; supply it as a query parameter or path segment
4615
CHW-4615 UnknownPersona
unknown persona; supply a recognised persona slug or omit the field to clear it
4616
CHW-4616 RepoTeamMappingInvalid
repo→team mapping payload failed validation; both repoPattern and team are required
4617
CHW-4617 RepoTeamMappingNotFound
repo→team mapping not found in this organisation
4618
CHW-4618 RepoTeamMappingConflict
repo→team mapping with this pattern already exists in the organisation
4701
CHW-4701 WebhookRequestBodyInvalid
webhook request body was missing or malformed; supply a JSON object with url (and optionally enabled) fields
4702
CHW-4702 WebhookURLRequired
webhook url is required
4703
CHW-4703 WebhookURLInvalid
webhook url was rejected; it must be an https URL pointing to a publicly routable host
4704
CHW-4704 WebhookLimitReached
maximum of 5 webhooks per user; delete an existing webhook before creating a new one
4705
CHW-4705 WebhookIDRequired
webhook id is required in the path; use /api/webhooks/{id}
4706
CHW-4706 WebhookNotFound
webhook not found
4707
CHW-4707 SIEMIntegrationIDRequired
SIEM integration id is required in the path; use /api/siem/integrations/{id}
4708
CHW-4708 SIEMIntegrationNotFound
SIEM integration not found
4709
CHW-4709 SIEMConfigInvalid
SIEM integration config failed validation; check name, provider, and provider-specific config fields
4710
CHW-4710 SCIMTokenNotFound
SCIM token not found
4711
CHW-4711 SCIMTokenRequestInvalid
SCIM token request was malformed; see /api/orgs/{org_id}/scim/tokens docs for the expected shape
4712
CHW-4712 SAMLSlugRequired
organization slug is required in the path; use /api/auth/saml/metadata/{slug}
4713
CHW-4713 SAMLNotConfigured
SAML SSO is not configured for this organization
4714
CHW-4714 SAMLProviderMismatch
the configured SSO provider for this organization is not SAML; use the OIDC metadata endpoint instead
4715
CHW-4715 PersonaPayloadInvalid
persona payload was missing or malformed; supply a JSON object with optional persona, inferred, and skipped fields
4716
CHW-4716 PersonaUnknown
persona value is not recognised; supported values are appsec, devsecops, enterprise_it
4717
CHW-4717 PostmarkWebhookBodyUnreadable
could not read postmark webhook body; the request was truncated or the connection dropped mid-request
4718
CHW-4718 PostmarkWebhookBodyTooLarge
postmark webhook body exceeded the 256 KiB limit
4719
CHW-4719 EmailRecipientSuppressed
email send skipped because the recipient is in the local postmark suppression ledger (hard bounce, spam complaint, or manual suppression)
4801
CHW-4801 ClientIDRequired
client identifier is required; supply it in the URL path (/api/clients/{client_id})
4802
CHW-4802 ClientCredentialPayloadInvalid
client credential payload could not be decoded; ensure the body is a JSON object matching the schema
4803
CHW-4803 ClientCredentialConflict
client credential fields are invalid or conflict with an existing record; verify client_id, client_type, and expiry_date
4804
CHW-4804 ClientCredentialNotFound
client credential not found; verify the client id and that it has not been deleted
4805
CHW-4805 QuarantinePackageRequired
quarantine action requires a package name segment in the path before /versions/
4806
CHW-4806 QuarantineRequestInvalid
quarantine request body could not be decoded; supply a JSON object with optional reason and logical_paths fields
4807
CHW-4807 QuarantineArtifactsNotFound
no cached artifacts found for this package version; nothing to quarantine
4808
CHW-4808 UploadParseFailed
upload could not be parsed; verify the request body matches the ecosystem's publish protocol
4809
CHW-4809 UploadCoordinateMissing
could not determine package name and version from upload; include the package metadata expected by the ecosystem
4810
CHW-4810 UploadPackageNotRegistered
the uploaded package is not registered in this repository; ask an admin to create a package slug before publishing
4811
CHW-4811 UploadPackageWriteDenied
the client does not have write permission for this package on this repository; ask an admin to grant package-permissions.write
4812
CHW-4812 UploadVersionConflict
this package version already exists; delete it first to republish, or publish a new version
4813
CHW-4813 DockerUploadUUIDMissing
docker blob upload request is missing the upload UUID segment
4814
CHW-4814 DockerUploadSessionNotFound
docker blob upload session not found; the session may have expired — re-initiate the push
4815
CHW-4815 DockerDigestRequired
docker blob upload completion requires the ?digest= query parameter
4816
CHW-4816 DockerManifestPathInvalid
docker manifest push path is malformed; expected {name}/manifests/{reference}
4817
CHW-4817 DockerPushOperationUnsupported
unsupported docker push operation; only blob upload and manifest push are implemented
4818
CHW-4818 RepositoryMissing
repository name is required in the path; use /api/repos/{repository}/...
4819
CHW-4819 APIRouteUnsupported
unsupported API route; see /api/openapi.yaml for the list of supported endpoints
4820
CHW-4820 PackagesPathInvalid
packages API path is invalid; expected /api/repos/{repository}/packages/{package...}
4821
CHW-4821 RepositoryPathNotFound
repository not found; verify the repository name and the org context
4822
CHW-4822 PackagePathNotFound
package not found in this repository; verify the package name
4823
CHW-4823 NuGetPackageIDRequired
FindPackagesById() requires the id query parameter
4824
CHW-4824 IdempotencyKeyConflict
Idempotency-Key was reused with a different request body; pick a fresh key or resend the original body to receive the cached response
4825
CHW-4825 ActionSourceInvalid
X-Chainsaw-Action-Source header value is not in the allowlist; valid sources are direct, inventory_view, coverage_silent, bypass_clients, bulk_action
4826
CHW-4826 BulkActionTooLarge
bulk action exceeded the maximum allowed items per request; split into smaller batches
4827
CHW-4827 BulkActionInvalid
bulk action failed up-front validation; nothing was committed — see the response body for per-item details
4828
CHW-4828 HardeningGateBlocked
K8s Fail-mode hardening bundle is blocked: cluster has not soaked safely in Ignore mode yet — see the gate object in the response for which criteria are unmet, or supply the typed-cluster-name ov…
4829
CHW-4829 AdmissionShadowPayloadInvalid
admission shadow decision payload is malformed; required fields are org_id, cluster, and decision (one of would_allow, would_block, internal_error)
4830
CHW-4830 RiskWeightsSimulateRequired
this org requires a preview before saving risk weights — POST /api/v1/intel/weights/simulate first and submit the returned simulate_id with your PUT
4831
CHW-4831 OrgDeleteSimulateRequired
this org requires a preview before deletion — POST /api/orgs/{id}/delete/preview first and submit the returned simulate_id on the DELETE
4832
CHW-4832 OrgDeleteSimulateStale
the org inventory drifted since the simulate was produced; re-run the preview before deleting
4833
CHW-4833 HardeningApprovalInvalid
the multi-key approval nonce is not valid — see the approval.reason field for the specific sub-reason (missing, expired, unsigned, self_signed, wrong_cluster, already_consumed)
4834
CHW-4834 RiskWeightsSimulateDegraded
the preview backing this save was degraded and projected nothing — re-run POST /api/v1/intel/weights/simulate, or resubmit with "acknowledge_degraded_preview": true to save against an empty proje…
4835
CHW-4835 OrgDeleteSimulateDegraded
the delete preview backing this request was degraded and could not compute the blast radius — re-run the preview once the database is healthy; there is no override for org delete
4840
CHW-4840 CocoapodsUnsupportedMediaType
Content-Type must be application/json; the cocoapods trunk only accepts JSON bodies
4841
CHW-4841 PodspecInvalid
podspec failed validation; verify the name, version, and source fields
4842
CHW-4842 TrunkRepositoryNotBound
trunk repository not bound to a tenant; verify the request lands inside a hosted-trunk repo prefix
4900
CHW-4900 RubyGemsDependencyAPIDeprecated
rubygems /api/v1/dependencies was deprecated upstream in 2023; use the Compact Index (versions, names, info/{name}), /api/v1/versions/{name}.json, or the legacy Marshal indexes (specs.4.8.gz) instead
4901
CHW-4901 ActionNotFound
action not found for this org; call list_recent_actions or /api/actions to find an id
4902
CHW-4902 ActionAlreadyUndone
action already undone; retrying will not change the state
4903
CHW-4903 ActionTypeUnsupported
undo is not supported for this action type; use the Web UI or delete+recreate the resource
4904
CHW-4904 ActionIrreversible
this action cannot be undone — the operation destroyed state (e.g. cleartext secret) that no surface can restore; mint a fresh credential instead
4910
CHW-4910 HardenQuorumNotMet
quorum not met; collect additional approvals before emitting the hardening bundle
4911
CHW-4911 HardenProposalNotFound
harden proposal not found for this org (it may have expired or belong to another org); list current proposals in the admin hardening dashboard at /admin/hardening
4912
CHW-4912 HardenAlreadyEmitted
harden bundle already emitted from this proposal; propose a new one to ship again
4913
CHW-4913 HardenSelfApproval
proposer cannot self-approve when quorum >= 2; ask a different org admin to approve
4914
CHW-4914 HardenAlreadyApproved
this user has already approved the proposal; quorum requires N distinct approvers
4915
CHW-4915 ActionIDRequired
action id is required in the URL path
4920
CHW-4920 APIKeyInvalidFilter
invalid key_type filter; expected 'personal' or 'agent'
4921
CHW-4921 APIKeyNameRequired
name is required
4922
CHW-4922 APIKeyInvalidKeyType
key_type / agent_kind combination is invalid; personal keys must omit agent_kind and agent keys must supply it
4923
CHW-4923 APIKeyInvalidScopes
either preset or scopes is required; supply one of the canonical preset names or a concrete scopes object
4924
CHW-4924 APIKeyIDRequired
missing api key id
4925
CHW-4925 APIKeyNotFound
api key not found
4926
CHW-4926 APIKeyNameEmpty
name cannot be empty
4927
CHW-4927 APIKeyInactive
api key is not active; rotate is only permitted on active keys
4928
CHW-4928 OrgDeleteSimulateExpired
simulate snapshot stale; re-run --dry-run
4929
CHW-4929 OrgDeleteSimulateKindMismatch
simulate_id was minted for a different action; mint a fresh one with `chainsaw org delete --dry-run`
4940
CHW-4940 CLINonceInvalid
invalid nonce; expected a hex string of 16-128 characters
4941
CHW-4941 CLIPortOutOfRange
port out of range; supply a loopback-accessible port between 1024 and 65535
4942
CHW-4942 CLIDeviceCodeInvalid
missing or invalid device_code
4943
CHW-4943 CLIDeviceCodeExpired
device code not found or expired; restart the `chainsaw auth login` flow
4944
CHW-4944 CLIDeviceCodeConsumed
device code has already been consumed; restart the `chainsaw auth login` flow
4945
CHW-4945 CLIUserCodeRequired
user_code is required
4946
CHW-4946 CLIUserCodeNotFound
code not found or expired
4947
CHW-4947 CLIDeviceGrantConflict
device grant state changed between lookup and approval; restart the `chainsaw auth login` flow
4948
CHW-4948 CLIExchangeCodeInvalid
missing or invalid exchange code
4949
CHW-4949 CLIExchangeCodeExpired
exchange code not found, expired, or already used; restart the `chainsaw auth login` flow