Skip to content

API and CLI errors

Every error the API answers (code of the problem details) and every CLI error with a hint has a page here, at /docs/errors/<code>. Build diagnostics are in diagnostics.

Code Where en
validation_failed API 400 Request validation failed
malformed_request API 400 Malformed request
unauthenticated API 401 Authentication required
cross_site_request API 403 Cross-site request refused
workspace_suspended API 403 The workspace is suspended
component_disabled API 403 The component is disabled
suspension_state_changed API 409 The workspace’s suspension changed during the walk
captcha_failed API 403 The human check failed
abuse_reports_unavailable API 503 The abuse report channel is temporarily unavailable
abuse_case_closed API 409 The abuse case is already closed
usage_flag_reviewed API 409 The usage flag is already closed
insufficient_scope API 403 The credential lacks a required scope
permission_denied API 403 The workspace role does not permit this action
human_action_required API 403 This action is for a person in the portal
api_key_creation_requires_session API 403 Only a portal session creates API keys
api_key_scope_exceeds_role API 403 The requested scopes exceed the creator’s workspace role
user_preferences_require_session API 403 User preferences require a portal session
user_sessions_require_portal API 403 Session management requires a portal session
session_not_found API 404 Session not found
invitation_role_exceeds_role API 403 The invitation’s role is above the sender’s own role
invitation_email_mismatch API 403 The signed-in e-mail is not the one the invitation is for
invitation_requires_session API 403 Only a portal session accepts invitations
invitation_unavailable API 410 The invitation can no longer be accepted
invitation_already_pending API 409 This address already has a pending invitation
invitee_already_member API 409 This address already belongs to a member
invitation_not_pending API 409 The invitation is no longer pending
invitation_quota_exceeded API 429 Too many invitations sent today in this workspace
notification_quota_exceeded API 429 The confirmation could not be requested now
notification_token_invalid API 404 The notification link is not valid
owner_transfer_unavailable API 410 The ownership offer can no longer be accepted
owner_transfer_already_pending API 409 The workspace already has a pending ownership offer
owner_transfer_not_ready API 409 The ownership offer cannot be accepted yet
owner_recently_changed API 409 The workspace changed owner recently
workspace_has_subscription API 409 The workspace still has a subscription
lifecycle_rate_limited API 429 Too many deletion requests or ownership offers today
workspace_deletion_scheduled API 409 The workspace is scheduled for deletion
email_unavailable API 503 E-mail cannot be sent in this environment
session_required API 403 This route needs a portal session
invalid_preferences API 422 User preferences are invalid
legal_versions_changed API 409 The legal texts changed while the page was open
invalid_login_state API 400 Invalid or expired login
login_failed API 400 Login failed
identity_provider_unavailable API 503 Sign-in is not available
not_found API 404 Resource not found
method_not_allowed API 405 Method not allowed
unsupported_media_type API 415 Unsupported media type
request_rejected API 400 Request rejected
rate_limited API 429 Too many requests
client_has_sites API 409 The client still has sites
rate_limiter_unavailable API 503 Rate limiting is temporarily unavailable
invalid_cursor API 400 Invalid pagination cursor
idempotency_request_in_progress API 409 A request with this idempotency key is in progress
idempotency_key_reused API 422 Idempotency key reused with a different request
build_not_publishable API 409 The build cannot become a version
version_already_exists API 409 The version already exists
invalid_tag_name API 400 The tag name is not a valid custom element name
component_already_exists API 409 The workspace already has a component with this tag
tag_conflict API 409 Two components of the site use the same Custom Element tag
component_archived API 409 The component is archived
version_not_ready API 409 The version’s build did not succeed
breaking_change_not_allowed API 409 The version breaks the one in production
no_previous_version API 409 The channel has no earlier version to go back to
channel_moved API 409 The channel no longer points to the version the request expected
site_component_limit API 409 The site already has the most components its plan allows
site_props_invalid API 422 The site’s props do not fit the component
site_props_incompatible API 409 The site’s saved props do not fit the new version
site_props_conflict API 409 The site’s props changed since they were read
channel_has_no_version API 409 The channel has no version yet
plan_limit_reached API 402 The workspace reached a limit of its plan
invalid_webhook_signature API 400 The webhook signature is invalid
billing_conflict API 409 The billing request does not fit the workspace’s billing state
billing_unavailable API 503 Billing is temporarily unavailable
retention_exceeds_plan API 422 A collection cannot keep submissions longer than the plan does
api_key_in_use API 409 An API key cannot revoke itself
api_key_quota_exceeded API 409 The workspace reached its limit of active API keys
semver_bump_too_small API 409 The semver is too small for the manifest changes
breaking_collection_change API 409 The version breaks the schema of a collection that holds data
payload_too_large API 413 The request body is too large
source_package_invalid API 422 The source package is not valid
conversion_event_not_in_manifest API 422 The conversion event is not declared in the component’s manifest
export_too_large API 422 The export holds too many submissions
build_quota_exceeded API 429 The workspace reached its build limit for the last 7 days
platform_build_capacity API 429 The platform reached its weekly emergency build fuse
database_unavailable API 503 The service is temporarily unavailable
manifest_publish_unavailable API 503 The change was saved but the site manifest is not updated yet
internal_error API 500 Internal server error
configuration_error API 500 Service misconfigured
api.error CLI The API refused the request
sites.invalidHold CLI The hold is not 1 to 3 seconds
sites.invalidLoading CLI The loading value is not eager or idle
api.network CLI The API cannot be reached
publish.attachFailedAfterVersion CLI The version was created but attaching to the site failed
api.rateLimited CLI Too many requests
auth.notLoggedIn CLI Not logged in
auth.rejected CLI The API rejected the login
auth.forbidden CLI Not allowed
auth.humanActionRequired CLI This is for a person
input.missingFlag CLI A flag is required
agent.noProject CLI No Taggor project here
agent.noBundle CLI This CLI carries no agent files
agent.badTarget CLI Unknown agent
agent.unsafePath CLI Refused to write an agent file
agent.markers CLI The Taggor block markers cannot be read
agent.bundleCorrupt CLI The agent files in this CLI are damaged
publish.noProject CLI No taggor.json found
publish.buildTimeout CLI The build did not finish in time
pull.versionAndChannel CLI –version and –channel together
pull.noVersions CLI The component has no version to pull
pull.channelEmpty CLI The channel points to nothing
pull.hashMismatch CLI The downloaded source does not match its hash
pull.noHash CLI The API sent the source without its hash
pull.tooLarge CLI The source package is over the size limit
pull.packageRefused CLI The downloaded source was refused
pull.secrets CLI The downloaded source holds a credential
pull.notEmpty CLI The folder is not empty
projects.invalidDays CLI Invalid –older-than
projects.unsafeName CLI Not a project folder of Taggor
login.expired CLI The login code expired
login.denied CLI The login was denied
init.renamedProjectKey CLI taggor.json uses an older name for its component list
props.invalidName CLI Not a prop name
protection.invalidSuspects CLI Unknown choice for suspect submissions
protection.invalidDailyCap CLI The daily cap is not a whole number
protection.nothingToSet CLI Nothing to change
protection.aboveCeiling CLI The daily cap is above the platform’s ceiling
build.quotaExceeded CLI The workspace reached its build limit for the last 7 days
build.platformFuse CLI The platform paused new builds for the week
props.invalidKind CLI Unknown way to read the value
props.invalidValue CLI The value is not of the kind asked
props.notAttached CLI The component is not attached to the site
sites.deleteInPortal CLI Deleting a site is done in the portal
props.conflict CLI The site’s props kept changing
props.noVersion CLI The channel has no version yet
props.invalid CLI The API refused the prop value
config.invalidApiUrl CLI Invalid API URL