Errors

Branch on code, not on the message.

CodeStatusFix
ACTOR_CHANGEDCheck the key's scopes and organization with GET /api/v1/api-keys/me, then send the request again.
ADMITS_TOO_MANYShorten admits so it names fewer pass types, then send the request again.
API_KEY_CHILD_CANNOT_MINTCreate the key with the original parent key or from a signed-in session.
API_KEY_CHILD_WIDERRequest only scopes the parent key already holds, or create the key with a broader parent.
API_KEY_MODE_MISMATCHCall the rotate endpoint with a key in the same mode as the key you rotate.
API_KEY_NOT_FOUNDLook up the id with GET /api/v1/api-keys, using a key of the same mode.
API_KEY_NOT_ROTATABLECreate a new key with POST /api/v1/api-keys instead of rotating this one.
API_KEY_NO_APPROVALApprove on a paired scanner with a staff PIN.
API_KEY_ORG_REQUIREDCall scan endpoints with a key scoped to one organization.
API_KEY_PARENT_RETIRINGCreate the key with a key that is not retiring.
API_KEY_REQUIREDCall it with Authorization: Bearer $PASSBOOK_KEY.
API_KEY_RESTRICTED_ROUTECall this route with a key that has no template restriction.
API_KEY_RESTRICTION_UNSUPPORTEDSet templates and styles only on organization keys that hold pass, holder, template or NFC scopes.
API_KEY_RETIRE_SETLeave the key as it is, or create a replacement with POST /api/v1/api-keys.
API_KEY_ROUTECall this route from a paired scanner or a signed-in session.
API_KEY_SCAN_ORG_REQUIREDCreate keys with scan scopes under an organization, not the platform.
API_KEY_SCOPE_EXCEEDS_CREATORRequest only scopes your own key or role holds.
API_KEY_TERMINALS_REQUIREDSet terminals to at least one terminal.
API_KEY_TERMINALS_UNUSEDRemove terminals, or add the scans:write scope.
ARCHIVE_TOO_LARGERemove unused files and upload an archive under 15 MB.
ASSETS_INVALIDFix the files named in issues and upload the archive again.
ASSET_DIMENSIONSResize the image to the size named in issues and upload it again.
ASSET_NOT_FOUNDCheck the image name or id and that it belongs to this organization.
ASSET_NOT_PNGRe-export the image as a standard RGB or RGBA PNG and upload it again.
ASSET_SIZECompress the image below 1 MB and upload it again.
ASSET_SLOTUse a slot name from the pass type's image slots in the request path.
BLOCK_NOT_FOUNDCheck the block id and send the request again.
BLUEPRINT_NOT_SCANNABLECreate a template from the blueprint with POST /api/v1/templates/{id}/use, then set up scanning on it.
BRAND_IMAGE_NOT_FOUNDUpload the image with PUT /api/v1/orgs/{id}/branding/{slot} and use the URL it returns.
BRAND_MARK_NOT_ALLOWEDRemove the setting, or ask the platform owner to enable it for the organization.
BROADCAST_INVALID_INPUTFix the values named in issues; GET /api/v1/templates/{id}/input-schema lists the allowed inputs.
BROADCAST_NOT_CANCELLABLECheck the state with GET /api/v1/broadcasts/{id} and cancel only a draft or scheduled message.
BROADCAST_NOT_DRAFTSend only drafts, or create a new message with POST /api/v1/broadcasts.
BROADCAST_NOT_EDITABLECreate a new message with POST /api/v1/broadcasts instead.
BROADCAST_NOT_FOUNDCheck the id with GET /api/v1/broadcasts.
BROADCAST_NOT_RETRYABLECheck the state with GET /api/v1/broadcasts/{id} and retry only a failed or cancelled message.
BROADCAST_ORGRemove the organization change and update the message in its own organization.
BROADCAST_PASTSet at to a future time.
BROADCAST_TOO_FARSet at to a time within the next year.
BROADCAST_UNKNOWN_INPUTUse only input names from GET /api/v1/templates/{id}/input-schema.
BULK_RUN_ACTIVEWait for the running job to finish, then start the new one.
BUNDLE_DUPLICATE_PASSList each pass id once.
BUNDLE_EMPTYAdd at least one pass to the bundle.
BUNDLE_MODE_MISMATCHPut only passes of the bundle's mode in it.
BUNDLE_NOT_FOUNDCheck the id with GET /api/v1/bundles.
BUNDLE_TOO_LARGESplit the passes across smaller bundles.
BUNDLE_TOO_MANYSend at most 10 passes per bundle.
CAPTURED_EMAIL_NOT_FOUNDList emails with GET /api/v1/test-inbox and use an id from the result.
CAPTURE_DEVELOPER_ONLYMake your sandbox in the developer portal and call this in Test mode.
CAPTURE_NOT_STOREDSend the request again.
CAPTURE_TOO_LARGESend a smaller body.
CAPTURE_URL_FIXEDLeave the url out, or create a URL endpoint instead.
CONNECTION_CONFLICTFetch it with GET /api/v1/connections/{id} and send the change again.
CONNECTION_DISABLEDEnable it with PATCH /api/v1/connections/{id}, then send the request again.
CONNECTION_NOT_FOUNDCheck the id with GET /api/v1/connections.
CONNECTION_ORGUse a connection id from your own organization's GET /api/v1/connections.
CONNECTION_TRANSFER_PENDINGWait for the transfer to finish, then send the request again.
CONNECTOR_NOT_FOUNDList valid types with GET /api/v1/connectors.
CONNECTOR_UNKNOWNSet type to a value from GET /api/v1/connectors.
CREATE_STALELook the pass up by externalId with GET /api/v1/passes and update it instead of creating it again.
CREDENTIAL_REF_KEYSET_CONFIG_UNAVAILABLERetry with backoff; if it persists, send the requestId to support.
CREDENTIAL_REF_KEYSET_UNAVAILABLERetry with backoff; if it persists, send the requestId to support.
CSRF_ORIGINCall the API server-side with an API key in the Authorization header instead of from a browser page.
DELIVERY_PENDINGWait for it to send, then check GET /api/v1/webhook-endpoints/{id}/deliveries before replaying.
DELIVERY_STALEReview the recipient and try again.
DEVICE_REQUIREDName the terminal in the device header on scan calls; open live connections from a paired scanner.
DEVICE_TOKEN_UNAVAILABLERetry the request; if it persists, send the requestId to support.
EMAIL_INVALIDSend a valid address in the email field.
EMAIL_OUTCOME_UNKNOWNCheck the pass's delivery status before sending again, to avoid a duplicate email.
EMAIL_RATE_LIMITEDWait for Retry-After, then retry.
ENROLLMENT_ENDEDStart a new enrollment request.
ENROLLMENT_NOT_FOUNDCheck the enrollment id and start a new request if it expired.
ENTITLEMENTS_CHANGEDFetch them with GET /api/v1/orgs/{id}/entitlements and send your change again.
EVENT_ARCHIVEDUse an event that is not archived, or create a new one.
EVENT_IN_USEEnd or change the sessions that use the event, then send the request again.
EVENT_MATCH_INPUTSet the match input to a single-value input from GET /api/v1/templates/{id}/input-schema.
EVENT_NEEDS_CAPACITYSet the event's capacity, then send the request again.
EVENT_NOT_FOUNDCheck the id with GET /api/v1/scan/events.
EVENT_TEMPLATE_NO_CHECK_INPick a template that defines check-in, or add the action to this one.
EVENT_TEMPLATE_RELEASE_REQUIREDApprove a release for the template with POST /api/v1/templates/{id}/releases, then retry.
EXPIRY_PASTSend a future time in milliseconds.
EXTERNAL_ID_TAKENSend a new externalId, or PATCH the existing pass.
FORBIDDENUse a key with the scope the operation lists, or ask an org admin.
GOOGLE_CALLBACK_INVALIDSend callbacks only from Google; check the callback URL set in Google Wallet.
GOOGLE_CALLBACK_UNAVAILABLERetry with backoff; Google resends failed callbacks.
GOOGLE_ISSUER_NOT_OWNEDShare an issuer your Google account owns, then send the request again.
GOOGLE_ISSUER_NOT_SHAREDShare the issuer in the Google Pay and Wallet console, then send the request again.
GOOGLE_UNAVAILABLESend the request again in a minute.
GROUP_ENTRY_ONLYUse check in all only on an entry scanner.
HOLDER_CHANGEDFetch the pass with GET /api/v1/passes/{id} and send the request again.
HOLDER_EMAIL_INVALIDCorrect the email in the source system, then sync the connection again.
HOLDER_OWNEDUse POST /api/v1/holders/reassign to move it.
HOLDER_TRANSFER_PENDINGWait for the transfer to finish, then send the request again.
IAM_BAD_ACCOUNTSend the request again; contact support if it repeats.
IAM_BAD_KEYSend the request again; contact support if it repeats.
IDEMPOTENCY_IN_PROGRESSWait a moment and resend the identical request.
IDEMPOTENCY_KEY_INVALIDSend a unique string of 1 to 200 characters, such as a UUID.
IDEMPOTENCY_KEY_REUSEDUse a new key for a new request; resend the identical request to replay.
IDENTITY_NOT_FOUNDCheck the id with GET /api/v1/identities.
IF_MATCH_INVALIDSend the version from the last GET, for example If-Match: 3.
IMAGE_BYTESCompress the image and upload it again.
IMAGE_INVALIDExport a standard PNG and upload it again.
IMAGE_NOT_FOUNDUpload one with PUT /api/v1/orgs/{id}/branding/{slot}.
IMAGE_SCALEResize so the @2x image is two thirds of the @3x, then upload both.
IMAGE_SIZEResize to the size named in issues and upload it again.
IMPORT_BUSYWait for it to finish with GET /api/v1/pass-imports/{id}, then retry.
IMPORT_COLUMN_MISSINGAdd the column to the file, or change the mapping, then check again.
IMPORT_CONFLICTSend the request again.
IMPORT_EMPTYUpload a CSV with a header line and one tag per row.
IMPORT_EXPIREDUpload the file again with POST /api/v1/pass-imports.
IMPORT_FILE_GONEUpload it again.
IMPORT_HAS_ERRORSFix the rows listed in GET /api/v1/pass-imports/{id}/errors.csv, or skip them, then commit again.
IMPORT_HEADERStart the file with a header line naming the uid and key columns.
IMPORT_HEADER_TOO_LONGShorten the header and upload the file again.
IMPORT_ID_TAKENCheck the import again with POST /api/v1/pass-imports/{id}/check, then commit.
IMPORT_NOT_FOUNDCheck the id with GET /api/v1/pass-imports.
IMPORT_PASS_CHANGEDRemove the pass on its own with POST /api/v1/passes/{id}/remove.
IMPORT_PLAN_INVALIDFix the mapping entries named in issues and check again.
IMPORT_ROW_UNRESERVEDRetry the commit; if it persists, send the requestId to support.
IMPORT_STATECheck its state with GET /api/v1/pass-imports/{id} and call the action that state allows.
IMPORT_TOO_MANYSplit the file and import it in parts.
INVALID_API_KEYCreate a new key in the console and update PASSBOOK_KEY.
INVALID_CURSORPass the nextCursor from the previous page unchanged, or drop it to start over.
INVALID_INPUTFix the inputs named in issues; GET /api/v1/templates/{id}/input-schema lists them.
INVITATION_INVALIDAsk an organization admin to send a new invitation with POST /api/v1/orgs/{id}/invitations.
INVITATION_PENDINGRevoke it to send a new one.
JOIN_NOT_READYPublish the template, then enable the link with PUT /api/v1/join-links/{templateId}.
KEYSET_CHANGEDFetch the keyset and send the change again.
KEYSET_KEY_INVALIDSend each key as 32 hexadecimal characters.
KEYSET_KEY_NOT_FOUNDCheck the key version against the keyset's list and send it again.
KEYSET_KEY_REUSEDSend new keys this organization has never used.
KEYSET_KEY_WEAKSend two different, randomly generated keys.
KEYSET_NOT_FOUNDCheck the keyset id and the key's mode.
KEY_CREATOR_GONECreate a new key with POST /api/v1/api-keys.
KEY_CREATOR_NOT_MEMBERCreate a new key from a current member with POST /api/v1/api-keys.
KEY_TEST_ONLYUse a pb_test_ key.
LAST_ORG_ADMINMake someone else an org admin first.
LINK_NOT_FOUNDRequest a fresh link, for example with POST /api/v1/bundles/{id}/rotate-link.
MANIFEST_INVALIDFix the manifest fields listed in issues and upload it again.
MATCH_NEEDS_TEMPLATESend orgId and templateId with the input filter.
MEMBERSHIP_CONFLICTFetch it with GET /api/v1/orgs/{id}/memberships and send the change again.
MEMBER_PHOTO_CHANGEDFetch the pass with GET /api/v1/passes/{id} and save the photo again.
MEMBER_PHOTO_DIMENSIONSCrop the photo to a 270 by 270 pixel square and upload it again.
MEMBER_PHOTO_ENCODINGSend the photo as a PNG or JPEG file.
MEMBER_PHOTO_NOT_FOUNDAdd one with PUT /api/v1/passes/{id}/member-photo.
MEMBER_PHOTO_STYLEUse a template of that style, or remove the strip image.
MESSAGING_UNSUPPORTEDUse a template that defines a message field, or add one to it.
MISSING_SCOPECreate a key with the scope the operation lists under security.
MODE_MISMATCHUse objects and a key of the same mode.
MODE_UNSUPPORTEDCreate the connection in a mode the connector supports; GET /api/v1/connectors/{type} lists them.
NEW_CODE_UNSUPPORTEDReissue the pass with POST /api/v1/passes/bulk-reissue instead of requesting a new code.
NOTE_CAPDelete an old note before adding another.
NOTE_DEVICE_CAPAdd the note from another device or wait until tomorrow.
NOTE_HELDAsk an org admin to release the hold. Adding a note still works.
NOTE_NOT_FOUNDCheck the note id.
NOTE_ROLESign in as Desk staff or a manager with the staff PIN.
NOT_A_CAPTURE_ENDPOINTUse a capture endpoint: POST /api/v1/webhook-endpoints/capture returns your sandbox's.
NOT_A_ZIPUpload the template as a .zip file.
NOT_FOUNDCheck the id, and that the key's mode (test or live) matches the object.
NOT_INSIDEDo nothing; check occupancy before marking out.
NO_FILESend the archive as multipart form data in the file field.
NO_RECIPIENTSet the holder's email with PATCH /api/v1/passes/{id}, then send again.
NO_VERIFIED_EMAILVerify an email address on the account, then send again.
OFFLINE_OFFTurn on offline scanning for the session, or scan online.
OFFLINE_TOO_BIGNarrow the session to fewer events or pass types.
ORG_ACCESS_CHANGEDCheck access with GET /api/v1/api-keys/me, then send the request again.
ORG_CONFLICTFetch it with GET /api/v1/orgs/{id} and send the change again.
ORG_FORBIDDENUse a key scoped to this organization, or a platform key for platform-wide lists.
ORG_INACTIVEReactivate it with POST /api/v1/orgs/{orgId}/reopen or ask the platform owner.
ORG_MIXEDSend ids from one organization per request.
ORG_NOT_FOUNDCheck orgId with GET /api/v1/orgs.
ORG_PERSONAL_SINGLE_MEMBERUse a regular organization to work with others.
ORG_REQUIREDSend orgId with the request, or use a key scoped to one organization.
ORG_SLUG_RESERVEDChoose a different slug.
ORG_SLUG_TAKENChoose a different slug.
ORG_STATUS_ALONESend the status change in its own request, then the other edits.
PAIRING_INVALIDCreate a new pairing code and enter it again.
PASS_CONFLICTFetch the pass with GET /api/v1/passes/{id} and send the request again.
PASS_CONNECTION_MISMATCHLink it with PUT /api/v1/passes/{id}/connection, then send the request again.
PASS_FILE_MISSINGRebuild it with POST /api/v1/passes/{id}/refresh.
PASS_INPUT_INVALIDFix the inputs named in issues; GET /api/v1/templates/{id}/input-schema lists them.
PASS_INVALIDFix the problems named in issues in the template or inputs.
PASS_NOT_ACTIVERestore or unvoid the pass first, or use an active one.
PASS_NOT_FOUNDCheck the id with GET /api/v1/passes and the key's mode.
PASS_REF_TAKENUse a different ref, or update the existing pass.
PASS_REISSUE_REQUIREDReissue it with POST /api/v1/passes/bulk-reissue.
PASS_REMOVEDRestore it with POST /api/v1/passes/{id}/restore, then send the request again.
PASS_TRANSFER_NOT_FOUNDCheck the transfer id.
PASS_TRANSFER_PENDINGTry again shortly.
PHOTO_PASS_INACTIVEUse an active pass.
PHOTO_ROLESign in as Desk staff with the staff PIN.
PIN_GENERATION_FAILEDRetry the request.
PIN_INVALIDEnter the correct PIN; repeated misses lock the entry for a while.
PIN_MANAGER_REQUIREDName a manager in the request.
RATE_LIMITEDWait for Retry-After seconds, then retry. Back off on repeats.
RECIPIENT_NOT_HOLDERSend to the holder's email, or change it with PATCH /api/v1/passes/{id}.
REPLAY_NOT_QUEUEDSend the replay request again.
REPLAY_TOO_LARGENarrow the time range or replay in several smaller requests.
REPLY_TO_LINK_INVALIDRequest a new link with POST /api/v1/settings/reply-to/resend.
REPLY_TO_NOTHING_PENDINGSet a new reply-to address with PUT /api/v1/settings first.
REPLY_TO_RESEND_LIMITEDWait a minute, then call POST /api/v1/settings/reply-to/resend again.
RETENTION_RECEIPT_BUSYWait a few seconds and send the request again.
ROLE_NOT_ALLOWEDChange the role from the scanner's setup in the admin console.
ROLL_CALL_ENDEDStart a new roll call.
ROLL_CALL_NOT_FOUNDCheck the roll call id.
ROLL_CALL_NO_PLACESTurn on occupancy tracking for the session, then start the roll call.
ROLL_CALL_NO_SESSIONAssign the scanner to a session in the admin console, then start the roll call.
ROLL_CALL_TOO_LARGEMark people out in bulk before starting the roll call.
RULE_HOURS_NEED_DATETIMEUse a date-and-time input for the rule, or remove the hours.
RULE_INPUT_MISMATCHPick templates where the input has the same type.
RULE_INPUT_MISSINGUse an input name from GET /api/v1/templates/{id}/input-schema for every template.
RULE_LIMITPause one with POST /api/v1/message-rules/{id}/pause, then turn this one on.
RULE_NOT_FOUNDCheck the id with GET /api/v1/message-rules.
RULE_VERSIONFetch it with GET /api/v1/message-rules/{id} and send your change again.
SAMPLE_EVENT_LIVESend it to a Test endpoint, or send webhook.test.
SAMPLE_TEST_ONLYRequest sample passes from a test-mode scanner.
SAMSUNG_FIELDS_INVALIDSend callbacks only from Samsung Wallet; check the callback setup.
SAMSUNG_UNAUTHENTICATEDCheck the Samsung Wallet partner credentials stored for the organization.
SAMSUNG_UNAVAILABLERetry with backoff.
SANDBOX_PREVIEW_ONLYUse the preview card and QR in the console; live passes need a real organization.
SANDBOX_QUOTADelete test objects you no longer need, or move to an organization with live access.
SCANNER_ADMIN_ROLEUse a browser device for admin sign-in.
SCANNER_ADMIN_SETUP_EXISTSUse the existing admin setup.
SCANNER_ADMIN_USERCreate it signed in as that admin, and leave out another user.
SCANNER_CANNOT_SCANAssign events only to scanning devices.
SCANNER_CHANGEDFetch the scanner and send your change again.
SCANNER_EXPIREDPair the scanner again.
SCANNER_NAME_TAKENChoose a different name.
SCANNER_NOT_FOUNDCheck the scanner id and the key's mode.
SCANNER_NOT_PAIRABLEUse the pairing method for this device type.
SCANNER_NOT_TERMINALCreate a token only for a till scanner.
SCANNER_NO_TAGSPick a scanner with tag reading on.
SCANNER_OFFLINEOpen the scanner app, then send the request again.
SCANNER_REPAIRPair the scanner again with a new code.
SCANNER_REQUESTS_OFFTurn on tag requests for the scanner, or pick another.
SCANNER_REVOKEDPair a new scanner.
SCANNER_ROLE_INVALIDChoose a role the device supports.
SCANNER_SETUP_EXISTSUse the existing setup or give the new one another name.
SCANNER_UNASSIGNEDChoose what it accepts, then send the request again.
SCANNER_UNAUTHENTICATEDPair the scanner, then sign in with the staff PIN.
SCANNER_WATCH_INVALIDChoose at least one scanner or session to follow.
SCANNER_WATCH_MODEMove them to the same mode, or choose others.
SCANNER_WATCH_NOT_FOUNDRemove it from the watch list.
SCANNING_DEVICE_CHANGEDFetch the device and send your change again.
SCANNING_DEVICE_NOT_FOUNDCheck the device id.
SCANNING_HOLD_RANGEOpen scanning for at most 24 hours.
SCANNING_HOURS_NONEPause the session instead, or add scanning hours.
SCANNING_SESSION_CHANGEDFetch the session and send your change again.
SCANNING_SESSION_CLOSEDWait for the next opening, or open it for a while.
SCANNING_SESSION_CONFIG_REQUIREDChange the settings on the session, not on the device.
SCANNING_SESSION_COUNTS_UNAVAILABLERetry with backoff.
SCANNING_SESSION_MODEOpen the device in the session's mode.
SCANNING_SESSION_NOT_FOUNDCheck the session id.
SCANNING_SESSION_OPENDo nothing; close it first to change how long it stays open.
SCANNING_SESSION_PAUSEDResume the session, then scan again.
SCANNING_SESSION_SCOPE_INVALIDCorrect the session's scope and settings, then add the device.
SCANNING_SESSION_SETTINGS_INVALIDCorrect the session's settings, then retry.
SCAN_ACCESS_CHANGEDReload the session and send the request again.
SCAN_ADMIN_SETUP_REQUIREDChoose the admin setup in the console, then retry.
SCAN_BODY_INVALIDSend a JSON body with Content-Type: application/json.
SCAN_CONFIG_CHANGEDReload the scanner and scan again.
SCAN_COUNTS_UNAVAILABLERetry with backoff.
SCAN_CREDENTIAL_CHANGEDReconnect the scanner so it picks up the new credential.
SCAN_DISPLAY_PREVIEW_NOT_FOUNDCreate the preview again and use its new id.
SCAN_EVENT_CHANGEDFetch the event with GET /api/v1/scan/events and send your change again.
SCAN_EVENT_NOT_FOUNDCheck the event id with GET /api/v1/scan/events.
SCAN_EXPORT_RANGEExport up to 92 days per request.
SCAN_EXPORT_TOO_LARGENarrow the date range or filters and export in parts.
SCAN_HISTORY_UNAVAILABLERetry with backoff.
SCAN_IN_PROGRESSWait a moment and resend the identical request.
SCAN_KEY_REUSEDUse a new unique request key for each action.
SCAN_LIVE_ORIGINOpen the screen on the PassBook site.
SCAN_LOOKUP_DISABLEDTurn on lookup in the scanner's settings.
SCAN_MARK_OUT_INVALIDCheck who is inside, then mark out someone who is.
SCAN_MODE_MISMATCHUse a key and objects of the same mode.
SCAN_NOT_FOUNDCheck the scan id and the scanner's mode.
SCAN_NO_SESSIONAssign the scanner to a session in the admin console.
SCAN_OVERRIDE_FORBIDDENDo not retry; no one can let this person in.
SCAN_OVERRIDE_INVALIDOverride only scans that were refused for an overridable reason.
SCAN_OVERRIDE_NOTE_CLOSEDAdd the note when you override, not afterwards.
SCAN_OVERRIDE_TAKENDo nothing; check the scan's history.
SCAN_PASS_CHANGEDScan the pass again.
SCAN_SCOPE_NOT_ALLOWEDLeave out the scope; a paired scanner uses its own.
SCAN_SCOPE_REQUIREDSend orgId, or use a key scoped to one organization.
SCAN_SEARCH_FORBIDDENSearch by pass id or code, or sign in as an administrator.
SCAN_SETTINGS_INVALIDCorrect the settings named in issues, then retry.
SCAN_SETUP_CONFLICTRemove the template from the other session, or reuse that session.
SCAN_STAFF_CHANGEDFetch the staff list and send the request again.
SCAN_STAFF_CURSORDrop the cursor and list again from the start.
SCAN_STAFF_NOT_FOUNDCheck the id with the scanner's staff list.
SCAN_SUMMARY_SESSION_FORBIDDENSign in with a manager PIN.
SCAN_SURFACE_UNSUPPORTEDUse a screen device for displays.
SCAN_TOO_MANY_MISSESWait a few minutes, then scan again.
SCAN_TOO_MANY_OVERRIDESWait for the next hour, or ask a manager.
SCAN_UNDO_EXPIREDCorrect the record by other means, such as marking the person out.
SCAN_UNDO_FORBIDDENAsk a manager, or the operator who made the scan, to undo it.
SCAN_WINDOW_INVALIDSet an end after the start, or fix the template's dates.
SCREEN_ONLYUse a scanner device for scanning.
SCREEN_REQUIREDChoose a screen view for the device in Scanning.
SECRET_UNAVAILABLERotate the secret with POST /api/v1/webhook-endpoints/{id}/secret, then send the request again.
SERIAL_TAKENSend a different serial, or leave it out to have one generated.
SESSION_OPEN_FORBIDDENSign in with a manager PIN, then open it.
SESSION_REQUIREDDo it in the console, or sign in as the account that started it.
SETTINGS_CHANGEDFetch them with GET /api/v1/settings and send your change again.
STAFF_NAME_REQUIREDSend staffId with the PIN.
STAFF_NAME_TAKENChoose a different name.
STAFF_REQUIREDSign in with a staff PIN, then retry.
STAFF_SIGN_IN_DISABLEDTurn on staff sign-in in the scanner's settings.
STAFF_SIGN_IN_UNAVAILABLEPair the scanner, then sign in.
STAMPS_ABOVE_MAXRaise the template's stamp maximum, or redeem stamps first.
STAMPS_CARD_FULLRedeem the reward, then add stamps.
STAMPS_NONEUse a template with stamps.
STAMPS_NO_REWARDAdd stamps until the card is full, then redeem.
STAMPS_QUERYRetry the request.
STAMPS_REDRAWMake the change in the template designer and publish a new version.
TAGS_OFFTurn on tags in the organization's settings.
TAG_ALREADY_ASSIGNEDFetch the tag and check its holder before reassigning.
TAG_APPROVAL_REQUIREDHave a manager approve it with their PIN.
TAG_ASSIGN_FORBIDDENTurn on assigning in the scanner's settings, or sign in as Desk or above.
TAG_ASSURANCE_LOWAssign a secure tag type to the pass.
TAG_CARD_AMBIGUOUSScan the card again, or assign the tag to a pass directly.
TAG_CHECK_FAILEDUse a different tag.
TAG_HOLDER_CHANGEDFetch the tag and send the request again.
TAG_ID_INVALIDCheck the ID against the reader or the supplier's list.
TAG_KEY_UNREADABLERetry once; if it persists, send the requestId to support.
TAG_LIMITRelease unused tags, or ask the platform owner to raise the limit.
TAG_NOT_ASSIGNEDAssign the tag before this action.
TAG_NOT_FOUNDCheck the tag id.
TAG_NO_ACCOUNTAssign the tag to the pass instead.
TAG_PASS_NOT_ACCEPTEDAdd the pass's template or event to the scanner's session.
TAG_POOL_UNSUPPORTEDAssign the tag to a pass or person instead.
TAG_REQUEST_BUSYCancel the open request or wait for it to finish.
TAG_REQUEST_EXPIREDCreate a new tag request.
TAG_SCANNER_ONLYAssign the tag from a paired scanner.
TAG_SECURE_REQUIREDUse a Secure (SUN) tag, or lower the session's tag level.
TAG_SUN_REPLAYTap the tag again for a fresh read.
TAG_SYSTEM_DISABLEDPick a tag system that is available, or contact the platform owner.
TAG_TYPED_OFFTap the tag on a scanner, or allow typed IDs on the tag type.
TAG_TYPE_ARCHIVEDRestore the tag type or use another.
TAG_TYPE_CHANGEDFetch the tag type and send your change again.
TAG_TYPE_CHOOSESend `typeId`, or set a default tag type for the organization.
TAG_TYPE_LIMITRemove the pass's current tag of this type first, or use another type.
TAG_TYPE_MISMATCHChoose a tag type that lists this pass's template.
TAG_TYPE_NAME_TAKENChoose a different name.
TAG_TYPE_NOT_FOUNDCheck the tag type id.
TAG_TYPE_SCOPEChoose a tag type with the scope you need.
TAG_TYPE_SETLeave `typeId` out, or change the tag's type in the console first.
TAG_TYPE_SYSTEMChoose a tag type for this tag's system.
TAG_UID_RANDOMUse a tag with a fixed ID.
TAG_UNDO_EXPIREDAdd the tag again.
TAG_UNDO_FORBIDDENUndo on that scanner, or have an admin remove the tag.
TAG_UNREADABLEHold the tag steady, or use another tag.
TAG_USE_MISMATCHChoose a tag type whose use the template accepts.
TEMPLATE_ARCHIVEDRestore it with POST /api/v1/templates/{id}/restore, or use another template.
TEMPLATE_ASSET_CONFLICTUpload the template version again.
TEMPLATE_BAKEDClone it with POST /api/v1/templates/{id}/clone and change the clone.
TEMPLATE_BLUEPRINT_INACTIVEPick another.
TEMPLATE_CANDIDATE_NOT_FOUNDCheck the id with GET /api/v1/templates/{id}/candidates.
TEMPLATE_CONFLICTFetch it with GET /api/v1/templates/{id} and send your change again.
TEMPLATE_CONTENT_CHANGEDSend the request again to use the current release.
TEMPLATE_EXISTSPick another name.
TEMPLATE_IN_TAG_TYPERemove it from the type first.
TEMPLATE_IN_USERemove it from them first.
TEMPLATE_IS_BLUEPRINTUse this blueprint to make one first.
TEMPLATE_MODE_MISMATCHUse a key of the template's mode.
TEMPLATE_NOT_BLUEPRINTDuplicate a template instead.
TEMPLATE_NOT_FOUNDCheck the id with GET /api/v1/templates and the key's mode.
TEMPLATE_NOT_RELEASEDRelease the template with POST /api/v1/templates/{id}/releases.
TEMPLATE_NOT_SHAREABLEShare an upload that no organization has taken.
TEMPLATE_NOT_TESTEDRelease it in Test first.
TEMPLATE_ORG_REQUIREDAssign the template to an organization, then retry.
TEMPLATE_PROVIDER_UNSUPPORTEDConfigure the provider for the organization, or release for another provider.
TEMPLATE_RELEASE_CONFLICTSend the request again to use the current release.
TEMPLATE_RELEASE_NOT_FOUNDCheck the id with GET /api/v1/templates/{id}/releases.
TEMPLATE_RELEASE_REQUIREDApprove a release with POST /api/v1/templates/{id}/candidates/{candidateId}/approve.
TEMPLATE_SELF_APPROVALHave a different member approve the candidate.
TEMPLATE_SLUG_CONFLICTSend the request again, or choose a different name.
TEMPLATE_USED_BY_OTHER_ORGReissue or delete them first.
TEMPLATE_VERSION_CONFLICTFetch the template and publish again.
TEMPLATE_VERSION_CONTENT_CONFLICTRun the sync again.
TEMPLATE_VERSION_NOT_FOUNDCheck the version with GET /api/v1/templates/{id}.
TERMINAL_NOT_FOUNDUse a terminal id from the key's terminals.
TERMINAL_ONLYName one of the key's terminals in the device header.
TERM_MANAGEDChange the term in the connected system.
TERM_NONERenew only passes whose template defines a term.
TERM_NOT_STARTEDRenew after the term starts.
TEST_FORWARD_ALREADY_ATTEMPTEDDo not send it again; check your inbox first.
TEST_FORWARD_CHANGEDSend it to yourself again.
TEST_FORWARD_OUTCOME_UNKNOWNDo not send this message again.
TEST_FORWARD_PREPARATION_FAILEDNothing was sent.
TEST_KEY_REQUIREDUse a key that starts with pb_test_.
UNAUTHENTICATEDSend Authorization: Bearer $PASSBOOK_KEY.
UNDO_SUPERSEDEDUndo the latest scan instead.
UNDO_UNCONFIRMEDCheck the scan's state, then retry once; if it persists, send the requestId to support.
UNKNOWN_TEMPLATEUse template ids from GET /api/v1/templates.
UNLOCK_REQUIREDEnter a staff PIN.
UNSAFE_URLUse a public https URL.
UPLOAD_NOT_FOUNDCheck the id with GET /api/v1/templates/uploads.
USER_NOT_FOUNDCheck the id with GET /api/v1/users.
VALIDATIONFix each field in issues and resend.
VERSION_CONFLICTGET the pass, apply your change to it, and resend with the new version.
VERSION_INVALIDUse a version number from GET /api/v1/templates/{id}.
VERSION_NOT_FOUNDCheck the version with GET /api/v1/passes/{id}.
VERSION_PURGEDRequest a newer version.
VISITOR_CHANGEDFetch the visitor list with GET /api/v1/visitors and send your change again.
VISITOR_HOST_NOTICE_FAILEDSend the request again; the visit is still recorded.
VISITOR_HOST_UNKNOWNChoose a host from GET /api/v1/visitors/hosts.
VISITOR_INCheck them out first.
VISITOR_NOT_FOUNDCheck the id with GET /api/v1/visitors.
VISITOR_NOT_INCheck them in before this action.
VISITOR_OUTDo nothing; check status with GET /api/v1/visitors.
VISITOR_RESEND_LIMITContact the host another way.
VISITOR_TEMPLATE_MISSINGSet up the visitor template in the console, then retry.
WALLET_ACCOUNT_CONFLICTFetch it again and send your change.
WALLET_ACCOUNT_INSTANCES_ACTIVERetire all provider instances, then revoke the account.
WALLET_ACCOUNT_MOVEDList accounts with GET /api/v1/wallet-providers/accounts and use the current one.
WALLET_ART_MISMATCHReplace the image with one at the size shown in issues.
WALLET_CREDENTIALS_INVALIDFix the credentials named in issues and send them again.
WALLET_CREDENTIALS_UNAVAILABLERetry with backoff.
WALLET_ENROLMENT_HELDAsk the platform owner to release the hold.
WALLET_ENROLMENT_PREREQUISITEFinish the steps listed in the response, then retry.
WALLET_IDENTITY_IMMUTABLECreate a new account for the new identity.
WALLET_IMAGE_NOT_FOUNDRebuild the wallet projection and use the new image URL.
WALLET_ISSUER_CLAIMEDUse a different issuer.
WALLET_ISSUER_EXISTSAttach it as a shared issuer instead.
WALLET_ISSUER_NOT_WAITINGCheck the issuer status before completing it.
WALLET_KEY_HELDMove the credential to the new key, then send the request again.
WALLET_MODE_MISMATCHUse a key of the same mode as the request.
WALLET_OFFER_NOT_FOUNDRequest a new offer for the pass.
WALLET_PLATFORM_CREDENTIAL_MISSINGAsk the platform owner to add it, then send the request again.
WALLET_PROJECTION_BLOCKEDFix the problems the response lists and build the projection again.
WALLET_PROJECTION_CONFLICTFetch the candidate again and send your request.
WALLET_PROJECTION_NOT_FOUNDCheck the id and create a candidate if it expired.
WALLET_PROJECTION_SCHEMACreate a new candidate from the current release.
WALLET_PROJECTION_UNSUPPORTEDRemove the unsupported features or release without this provider.
WALLET_RUN_BUSYSend the request again in a minute.
WALLET_VERIFICATION_CONFLICTWait for it to finish, then verify again if needed.
WEBHOOK_ALREADY_FINISHEDDo nothing; check its status with GET /api/v1/connections/{id}/webhook-failures.
WEBHOOK_CAPTURE_NOT_FOUNDList the endpoint's captures with GET /api/v1/webhook-endpoints/{id}/captures.
WEBHOOK_CONTEXT_CONFLICTResend the event from the source system.
WEBHOOK_DISPATCH_INCOMPLETERetry with backoff.
WEBHOOK_EFFECT_UNCERTAINResolve it with POST /api/v1/connections/{id}/webhook-failures/{retentionId}/resolve after checking the pass.
WEBHOOK_ENDPOINT_LIMITDelete one first.
WEBHOOK_ENDPOINT_NOT_FOUNDCheck the id with GET /api/v1/webhook-endpoints.
WEBHOOK_ENQUEUE_FAILEDRetry with backoff.
WEBHOOK_ITEM_BUSYRetry with backoff.
WEBHOOK_ITEM_PENDINGRetry with backoff.
WEBHOOK_NOTHING_TO_RESOLVEDo nothing; list failures with GET /api/v1/connections/{id}/webhook-failures.
WEBHOOK_NOT_FOUNDCheck the retentionId with GET /api/v1/connections/{id}/webhook-failures.
WEBHOOK_PAYLOADSend the body in the format the connector documents.
WEBHOOK_PAYLOAD_MISSINGRetry with backoff; if it persists, resend the event from the source.
WEBHOOK_REFERENCE_MODERetry with backoff.
WEBHOOK_REFERENCE_MODE_CHANGEDResend the event from the source system.
WEBHOOK_RESOLVE_CONFLICTList failures again and resolve once more.
WEBHOOK_RETENTION_FAILEDRetry with backoff.
WEBHOOK_RETENTION_UNAVAILABLERetry with backoff.
WEBHOOK_SIGNATURESign the body with the connection's current webhook secret.
WEBHOOK_SNAPSHOT_UNAVAILABLEResend the event from the source system instead of replaying.
WEBHOOK_STALE_CONTEXTResend the event from the source system.
WEBHOOK_STILL_PENDINGWait for it to run before resolving it.
WEBHOOK_UNAVAILABLERetry the webhook.
WEBHOOK_WORK_CHANGEDRetry with backoff.
WORKFLOW_STARTSend the request again.
ZONE_ARCHIVEDUse a zone that is not archived.
ZONE_CYCLEChoose a parent outside the zone.
ZONE_DEPTHMove the zone higher in the tree.
ZONE_EVENT_SESSIONUse a zone session, or remove the zones.
ZONE_KEY_TAKENChoose a different key.
ZONE_NAME_TAKENChoose a different name.
ZONE_NOT_FOUNDCheck the zone id.