Errors
Branch on code, not on the message.
| Code | Status | Fix |
|---|---|---|
| ACTOR_CHANGED | Check the key's scopes and organization with GET /api/v1/api-keys/me, then send the request again. | |
| ADMITS_TOO_MANY | Shorten admits so it names fewer pass types, then send the request again. | |
| API_KEY_CHILD_CANNOT_MINT | Create the key with the original parent key or from a signed-in session. | |
| API_KEY_CHILD_WIDER | Request only scopes the parent key already holds, or create the key with a broader parent. | |
| API_KEY_MODE_MISMATCH | Call the rotate endpoint with a key in the same mode as the key you rotate. | |
| API_KEY_NOT_FOUND | Look up the id with GET /api/v1/api-keys, using a key of the same mode. | |
| API_KEY_NOT_ROTATABLE | Create a new key with POST /api/v1/api-keys instead of rotating this one. | |
| API_KEY_NO_APPROVAL | Approve on a paired scanner with a staff PIN. | |
| API_KEY_ORG_REQUIRED | Call scan endpoints with a key scoped to one organization. | |
| API_KEY_PARENT_RETIRING | Create the key with a key that is not retiring. | |
| API_KEY_REQUIRED | Call it with Authorization: Bearer $PASSBOOK_KEY. | |
| API_KEY_RESTRICTED_ROUTE | Call this route with a key that has no template restriction. | |
| API_KEY_RESTRICTION_UNSUPPORTED | Set templates and styles only on organization keys that hold pass, holder, template or NFC scopes. | |
| API_KEY_RETIRE_SET | Leave the key as it is, or create a replacement with POST /api/v1/api-keys. | |
| API_KEY_ROUTE | Call this route from a paired scanner or a signed-in session. | |
| API_KEY_SCAN_ORG_REQUIRED | Create keys with scan scopes under an organization, not the platform. | |
| API_KEY_SCOPE_EXCEEDS_CREATOR | Request only scopes your own key or role holds. | |
| API_KEY_TERMINALS_REQUIRED | Set terminals to at least one terminal. | |
| API_KEY_TERMINALS_UNUSED | Remove terminals, or add the scans:write scope. | |
| ARCHIVE_TOO_LARGE | Remove unused files and upload an archive under 15 MB. | |
| ASSETS_INVALID | Fix the files named in issues and upload the archive again. | |
| ASSET_DIMENSIONS | Resize the image to the size named in issues and upload it again. | |
| ASSET_NOT_FOUND | Check the image name or id and that it belongs to this organization. | |
| ASSET_NOT_PNG | Re-export the image as a standard RGB or RGBA PNG and upload it again. | |
| ASSET_SIZE | Compress the image below 1 MB and upload it again. | |
| ASSET_SLOT | Use a slot name from the pass type's image slots in the request path. | |
| BLOCK_NOT_FOUND | Check the block id and send the request again. | |
| BLUEPRINT_NOT_SCANNABLE | Create a template from the blueprint with POST /api/v1/templates/{id}/use, then set up scanning on it. | |
| BRAND_IMAGE_NOT_FOUND | Upload the image with PUT /api/v1/orgs/{id}/branding/{slot} and use the URL it returns. | |
| BRAND_MARK_NOT_ALLOWED | Remove the setting, or ask the platform owner to enable it for the organization. | |
| BROADCAST_INVALID_INPUT | Fix the values named in issues; GET /api/v1/templates/{id}/input-schema lists the allowed inputs. | |
| BROADCAST_NOT_CANCELLABLE | Check the state with GET /api/v1/broadcasts/{id} and cancel only a draft or scheduled message. | |
| BROADCAST_NOT_DRAFT | Send only drafts, or create a new message with POST /api/v1/broadcasts. | |
| BROADCAST_NOT_EDITABLE | Create a new message with POST /api/v1/broadcasts instead. | |
| BROADCAST_NOT_FOUND | Check the id with GET /api/v1/broadcasts. | |
| BROADCAST_NOT_RETRYABLE | Check the state with GET /api/v1/broadcasts/{id} and retry only a failed or cancelled message. | |
| BROADCAST_ORG | Remove the organization change and update the message in its own organization. | |
| BROADCAST_PAST | Set at to a future time. | |
| BROADCAST_TOO_FAR | Set at to a time within the next year. | |
| BROADCAST_UNKNOWN_INPUT | Use only input names from GET /api/v1/templates/{id}/input-schema. | |
| BULK_RUN_ACTIVE | Wait for the running job to finish, then start the new one. | |
| BUNDLE_DUPLICATE_PASS | List each pass id once. | |
| BUNDLE_EMPTY | Add at least one pass to the bundle. | |
| BUNDLE_MODE_MISMATCH | Put only passes of the bundle's mode in it. | |
| BUNDLE_NOT_FOUND | Check the id with GET /api/v1/bundles. | |
| BUNDLE_TOO_LARGE | Split the passes across smaller bundles. | |
| BUNDLE_TOO_MANY | Send at most 10 passes per bundle. | |
| CAPTURED_EMAIL_NOT_FOUND | List emails with GET /api/v1/test-inbox and use an id from the result. | |
| CAPTURE_DEVELOPER_ONLY | Make your sandbox in the developer portal and call this in Test mode. | |
| CAPTURE_NOT_STORED | Send the request again. | |
| CAPTURE_TOO_LARGE | Send a smaller body. | |
| CAPTURE_URL_FIXED | Leave the url out, or create a URL endpoint instead. | |
| CONNECTION_CONFLICT | Fetch it with GET /api/v1/connections/{id} and send the change again. | |
| CONNECTION_DISABLED | Enable it with PATCH /api/v1/connections/{id}, then send the request again. | |
| CONNECTION_NOT_FOUND | Check the id with GET /api/v1/connections. | |
| CONNECTION_ORG | Use a connection id from your own organization's GET /api/v1/connections. | |
| CONNECTION_TRANSFER_PENDING | Wait for the transfer to finish, then send the request again. | |
| CONNECTOR_NOT_FOUND | List valid types with GET /api/v1/connectors. | |
| CONNECTOR_UNKNOWN | Set type to a value from GET /api/v1/connectors. | |
| CREATE_STALE | Look the pass up by externalId with GET /api/v1/passes and update it instead of creating it again. | |
| CREDENTIAL_REF_KEYSET_CONFIG_UNAVAILABLE | Retry with backoff; if it persists, send the requestId to support. | |
| CREDENTIAL_REF_KEYSET_UNAVAILABLE | Retry with backoff; if it persists, send the requestId to support. | |
| CSRF_ORIGIN | Call the API server-side with an API key in the Authorization header instead of from a browser page. | |
| DELIVERY_PENDING | Wait for it to send, then check GET /api/v1/webhook-endpoints/{id}/deliveries before replaying. | |
| DELIVERY_STALE | Review the recipient and try again. | |
| DEVICE_REQUIRED | Name the terminal in the device header on scan calls; open live connections from a paired scanner. | |
| DEVICE_TOKEN_UNAVAILABLE | Retry the request; if it persists, send the requestId to support. | |
| EMAIL_INVALID | Send a valid address in the email field. | |
| EMAIL_OUTCOME_UNKNOWN | Check the pass's delivery status before sending again, to avoid a duplicate email. | |
| EMAIL_RATE_LIMITED | Wait for Retry-After, then retry. | |
| ENROLLMENT_ENDED | Start a new enrollment request. | |
| ENROLLMENT_NOT_FOUND | Check the enrollment id and start a new request if it expired. | |
| ENTITLEMENTS_CHANGED | Fetch them with GET /api/v1/orgs/{id}/entitlements and send your change again. | |
| EVENT_ARCHIVED | Use an event that is not archived, or create a new one. | |
| EVENT_IN_USE | End or change the sessions that use the event, then send the request again. | |
| EVENT_MATCH_INPUT | Set the match input to a single-value input from GET /api/v1/templates/{id}/input-schema. | |
| EVENT_NEEDS_CAPACITY | Set the event's capacity, then send the request again. | |
| EVENT_NOT_FOUND | Check the id with GET /api/v1/scan/events. | |
| EVENT_TEMPLATE_NO_CHECK_IN | Pick a template that defines check-in, or add the action to this one. | |
| EVENT_TEMPLATE_RELEASE_REQUIRED | Approve a release for the template with POST /api/v1/templates/{id}/releases, then retry. | |
| EXPIRY_PAST | Send a future time in milliseconds. | |
| EXTERNAL_ID_TAKEN | Send a new externalId, or PATCH the existing pass. | |
| FORBIDDEN | Use a key with the scope the operation lists, or ask an org admin. | |
| GOOGLE_CALLBACK_INVALID | Send callbacks only from Google; check the callback URL set in Google Wallet. | |
| GOOGLE_CALLBACK_UNAVAILABLE | Retry with backoff; Google resends failed callbacks. | |
| GOOGLE_ISSUER_NOT_OWNED | Share an issuer your Google account owns, then send the request again. | |
| GOOGLE_ISSUER_NOT_SHARED | Share the issuer in the Google Pay and Wallet console, then send the request again. | |
| GOOGLE_UNAVAILABLE | Send the request again in a minute. | |
| GROUP_ENTRY_ONLY | Use check in all only on an entry scanner. | |
| HOLDER_CHANGED | Fetch the pass with GET /api/v1/passes/{id} and send the request again. | |
| HOLDER_EMAIL_INVALID | Correct the email in the source system, then sync the connection again. | |
| HOLDER_OWNED | Use POST /api/v1/holders/reassign to move it. | |
| HOLDER_TRANSFER_PENDING | Wait for the transfer to finish, then send the request again. | |
| IAM_BAD_ACCOUNT | Send the request again; contact support if it repeats. | |
| IAM_BAD_KEY | Send the request again; contact support if it repeats. | |
| IDEMPOTENCY_IN_PROGRESS | Wait a moment and resend the identical request. | |
| IDEMPOTENCY_KEY_INVALID | Send a unique string of 1 to 200 characters, such as a UUID. | |
| IDEMPOTENCY_KEY_REUSED | Use a new key for a new request; resend the identical request to replay. | |
| IDENTITY_NOT_FOUND | Check the id with GET /api/v1/identities. | |
| IF_MATCH_INVALID | Send the version from the last GET, for example If-Match: 3. | |
| IMAGE_BYTES | Compress the image and upload it again. | |
| IMAGE_INVALID | Export a standard PNG and upload it again. | |
| IMAGE_NOT_FOUND | Upload one with PUT /api/v1/orgs/{id}/branding/{slot}. | |
| IMAGE_SCALE | Resize so the @2x image is two thirds of the @3x, then upload both. | |
| IMAGE_SIZE | Resize to the size named in issues and upload it again. | |
| IMPORT_BUSY | Wait for it to finish with GET /api/v1/pass-imports/{id}, then retry. | |
| IMPORT_COLUMN_MISSING | Add the column to the file, or change the mapping, then check again. | |
| IMPORT_CONFLICT | Send the request again. | |
| IMPORT_EMPTY | Upload a CSV with a header line and one tag per row. | |
| IMPORT_EXPIRED | Upload the file again with POST /api/v1/pass-imports. | |
| IMPORT_FILE_GONE | Upload it again. | |
| IMPORT_HAS_ERRORS | Fix the rows listed in GET /api/v1/pass-imports/{id}/errors.csv, or skip them, then commit again. | |
| IMPORT_HEADER | Start the file with a header line naming the uid and key columns. | |
| IMPORT_HEADER_TOO_LONG | Shorten the header and upload the file again. | |
| IMPORT_ID_TAKEN | Check the import again with POST /api/v1/pass-imports/{id}/check, then commit. | |
| IMPORT_NOT_FOUND | Check the id with GET /api/v1/pass-imports. | |
| IMPORT_PASS_CHANGED | Remove the pass on its own with POST /api/v1/passes/{id}/remove. | |
| IMPORT_PLAN_INVALID | Fix the mapping entries named in issues and check again. | |
| IMPORT_ROW_UNRESERVED | Retry the commit; if it persists, send the requestId to support. | |
| IMPORT_STATE | Check its state with GET /api/v1/pass-imports/{id} and call the action that state allows. | |
| IMPORT_TOO_MANY | Split the file and import it in parts. | |
| INVALID_API_KEY | Create a new key in the console and update PASSBOOK_KEY. | |
| INVALID_CURSOR | Pass the nextCursor from the previous page unchanged, or drop it to start over. | |
| INVALID_INPUT | Fix the inputs named in issues; GET /api/v1/templates/{id}/input-schema lists them. | |
| INVITATION_INVALID | Ask an organization admin to send a new invitation with POST /api/v1/orgs/{id}/invitations. | |
| INVITATION_PENDING | Revoke it to send a new one. | |
| JOIN_NOT_READY | Publish the template, then enable the link with PUT /api/v1/join-links/{templateId}. | |
| KEYSET_CHANGED | Fetch the keyset and send the change again. | |
| KEYSET_KEY_INVALID | Send each key as 32 hexadecimal characters. | |
| KEYSET_KEY_NOT_FOUND | Check the key version against the keyset's list and send it again. | |
| KEYSET_KEY_REUSED | Send new keys this organization has never used. | |
| KEYSET_KEY_WEAK | Send two different, randomly generated keys. | |
| KEYSET_NOT_FOUND | Check the keyset id and the key's mode. | |
| KEY_CREATOR_GONE | Create a new key with POST /api/v1/api-keys. | |
| KEY_CREATOR_NOT_MEMBER | Create a new key from a current member with POST /api/v1/api-keys. | |
| KEY_TEST_ONLY | Use a pb_test_ key. | |
| LAST_ORG_ADMIN | Make someone else an org admin first. | |
| LINK_NOT_FOUND | Request a fresh link, for example with POST /api/v1/bundles/{id}/rotate-link. | |
| MANIFEST_INVALID | Fix the manifest fields listed in issues and upload it again. | |
| MATCH_NEEDS_TEMPLATE | Send orgId and templateId with the input filter. | |
| MEMBERSHIP_CONFLICT | Fetch it with GET /api/v1/orgs/{id}/memberships and send the change again. | |
| MEMBER_PHOTO_CHANGED | Fetch the pass with GET /api/v1/passes/{id} and save the photo again. | |
| MEMBER_PHOTO_DIMENSIONS | Crop the photo to a 270 by 270 pixel square and upload it again. | |
| MEMBER_PHOTO_ENCODING | Send the photo as a PNG or JPEG file. | |
| MEMBER_PHOTO_NOT_FOUND | Add one with PUT /api/v1/passes/{id}/member-photo. | |
| MEMBER_PHOTO_STYLE | Use a template of that style, or remove the strip image. | |
| MESSAGING_UNSUPPORTED | Use a template that defines a message field, or add one to it. | |
| MISSING_SCOPE | Create a key with the scope the operation lists under security. | |
| MODE_MISMATCH | Use objects and a key of the same mode. | |
| MODE_UNSUPPORTED | Create the connection in a mode the connector supports; GET /api/v1/connectors/{type} lists them. | |
| NEW_CODE_UNSUPPORTED | Reissue the pass with POST /api/v1/passes/bulk-reissue instead of requesting a new code. | |
| NOTE_CAP | Delete an old note before adding another. | |
| NOTE_DEVICE_CAP | Add the note from another device or wait until tomorrow. | |
| NOTE_HELD | Ask an org admin to release the hold. Adding a note still works. | |
| NOTE_NOT_FOUND | Check the note id. | |
| NOTE_ROLE | Sign in as Desk staff or a manager with the staff PIN. | |
| NOT_A_CAPTURE_ENDPOINT | Use a capture endpoint: POST /api/v1/webhook-endpoints/capture returns your sandbox's. | |
| NOT_A_ZIP | Upload the template as a .zip file. | |
| NOT_FOUND | Check the id, and that the key's mode (test or live) matches the object. | |
| NOT_INSIDE | Do nothing; check occupancy before marking out. | |
| NO_FILE | Send the archive as multipart form data in the file field. | |
| NO_RECIPIENT | Set the holder's email with PATCH /api/v1/passes/{id}, then send again. | |
| NO_VERIFIED_EMAIL | Verify an email address on the account, then send again. | |
| OFFLINE_OFF | Turn on offline scanning for the session, or scan online. | |
| OFFLINE_TOO_BIG | Narrow the session to fewer events or pass types. | |
| ORG_ACCESS_CHANGED | Check access with GET /api/v1/api-keys/me, then send the request again. | |
| ORG_CONFLICT | Fetch it with GET /api/v1/orgs/{id} and send the change again. | |
| ORG_FORBIDDEN | Use a key scoped to this organization, or a platform key for platform-wide lists. | |
| ORG_INACTIVE | Reactivate it with POST /api/v1/orgs/{orgId}/reopen or ask the platform owner. | |
| ORG_MIXED | Send ids from one organization per request. | |
| ORG_NOT_FOUND | Check orgId with GET /api/v1/orgs. | |
| ORG_PERSONAL_SINGLE_MEMBER | Use a regular organization to work with others. | |
| ORG_REQUIRED | Send orgId with the request, or use a key scoped to one organization. | |
| ORG_SLUG_RESERVED | Choose a different slug. | |
| ORG_SLUG_TAKEN | Choose a different slug. | |
| ORG_STATUS_ALONE | Send the status change in its own request, then the other edits. | |
| PAIRING_INVALID | Create a new pairing code and enter it again. | |
| PASS_CONFLICT | Fetch the pass with GET /api/v1/passes/{id} and send the request again. | |
| PASS_CONNECTION_MISMATCH | Link it with PUT /api/v1/passes/{id}/connection, then send the request again. | |
| PASS_FILE_MISSING | Rebuild it with POST /api/v1/passes/{id}/refresh. | |
| PASS_INPUT_INVALID | Fix the inputs named in issues; GET /api/v1/templates/{id}/input-schema lists them. | |
| PASS_INVALID | Fix the problems named in issues in the template or inputs. | |
| PASS_NOT_ACTIVE | Restore or unvoid the pass first, or use an active one. | |
| PASS_NOT_FOUND | Check the id with GET /api/v1/passes and the key's mode. | |
| PASS_REF_TAKEN | Use a different ref, or update the existing pass. | |
| PASS_REISSUE_REQUIRED | Reissue it with POST /api/v1/passes/bulk-reissue. | |
| PASS_REMOVED | Restore it with POST /api/v1/passes/{id}/restore, then send the request again. | |
| PASS_TRANSFER_NOT_FOUND | Check the transfer id. | |
| PASS_TRANSFER_PENDING | Try again shortly. | |
| PHOTO_PASS_INACTIVE | Use an active pass. | |
| PHOTO_ROLE | Sign in as Desk staff with the staff PIN. | |
| PIN_GENERATION_FAILED | Retry the request. | |
| PIN_INVALID | Enter the correct PIN; repeated misses lock the entry for a while. | |
| PIN_MANAGER_REQUIRED | Name a manager in the request. | |
| RATE_LIMITED | Wait for Retry-After seconds, then retry. Back off on repeats. | |
| RECIPIENT_NOT_HOLDER | Send to the holder's email, or change it with PATCH /api/v1/passes/{id}. | |
| REPLAY_NOT_QUEUED | Send the replay request again. | |
| REPLAY_TOO_LARGE | Narrow the time range or replay in several smaller requests. | |
| REPLY_TO_LINK_INVALID | Request a new link with POST /api/v1/settings/reply-to/resend. | |
| REPLY_TO_NOTHING_PENDING | Set a new reply-to address with PUT /api/v1/settings first. | |
| REPLY_TO_RESEND_LIMITED | Wait a minute, then call POST /api/v1/settings/reply-to/resend again. | |
| RETENTION_RECEIPT_BUSY | Wait a few seconds and send the request again. | |
| ROLE_NOT_ALLOWED | Change the role from the scanner's setup in the admin console. | |
| ROLL_CALL_ENDED | Start a new roll call. | |
| ROLL_CALL_NOT_FOUND | Check the roll call id. | |
| ROLL_CALL_NO_PLACES | Turn on occupancy tracking for the session, then start the roll call. | |
| ROLL_CALL_NO_SESSION | Assign the scanner to a session in the admin console, then start the roll call. | |
| ROLL_CALL_TOO_LARGE | Mark people out in bulk before starting the roll call. | |
| RULE_HOURS_NEED_DATETIME | Use a date-and-time input for the rule, or remove the hours. | |
| RULE_INPUT_MISMATCH | Pick templates where the input has the same type. | |
| RULE_INPUT_MISSING | Use an input name from GET /api/v1/templates/{id}/input-schema for every template. | |
| RULE_LIMIT | Pause one with POST /api/v1/message-rules/{id}/pause, then turn this one on. | |
| RULE_NOT_FOUND | Check the id with GET /api/v1/message-rules. | |
| RULE_VERSION | Fetch it with GET /api/v1/message-rules/{id} and send your change again. | |
| SAMPLE_EVENT_LIVE | Send it to a Test endpoint, or send webhook.test. | |
| SAMPLE_TEST_ONLY | Request sample passes from a test-mode scanner. | |
| SAMSUNG_FIELDS_INVALID | Send callbacks only from Samsung Wallet; check the callback setup. | |
| SAMSUNG_UNAUTHENTICATED | Check the Samsung Wallet partner credentials stored for the organization. | |
| SAMSUNG_UNAVAILABLE | Retry with backoff. | |
| SANDBOX_PREVIEW_ONLY | Use the preview card and QR in the console; live passes need a real organization. | |
| SANDBOX_QUOTA | Delete test objects you no longer need, or move to an organization with live access. | |
| SCANNER_ADMIN_ROLE | Use a browser device for admin sign-in. | |
| SCANNER_ADMIN_SETUP_EXISTS | Use the existing admin setup. | |
| SCANNER_ADMIN_USER | Create it signed in as that admin, and leave out another user. | |
| SCANNER_CANNOT_SCAN | Assign events only to scanning devices. | |
| SCANNER_CHANGED | Fetch the scanner and send your change again. | |
| SCANNER_EXPIRED | Pair the scanner again. | |
| SCANNER_NAME_TAKEN | Choose a different name. | |
| SCANNER_NOT_FOUND | Check the scanner id and the key's mode. | |
| SCANNER_NOT_PAIRABLE | Use the pairing method for this device type. | |
| SCANNER_NOT_TERMINAL | Create a token only for a till scanner. | |
| SCANNER_NO_TAGS | Pick a scanner with tag reading on. | |
| SCANNER_OFFLINE | Open the scanner app, then send the request again. | |
| SCANNER_REPAIR | Pair the scanner again with a new code. | |
| SCANNER_REQUESTS_OFF | Turn on tag requests for the scanner, or pick another. | |
| SCANNER_REVOKED | Pair a new scanner. | |
| SCANNER_ROLE_INVALID | Choose a role the device supports. | |
| SCANNER_SETUP_EXISTS | Use the existing setup or give the new one another name. | |
| SCANNER_UNASSIGNED | Choose what it accepts, then send the request again. | |
| SCANNER_UNAUTHENTICATED | Pair the scanner, then sign in with the staff PIN. | |
| SCANNER_WATCH_INVALID | Choose at least one scanner or session to follow. | |
| SCANNER_WATCH_MODE | Move them to the same mode, or choose others. | |
| SCANNER_WATCH_NOT_FOUND | Remove it from the watch list. | |
| SCANNING_DEVICE_CHANGED | Fetch the device and send your change again. | |
| SCANNING_DEVICE_NOT_FOUND | Check the device id. | |
| SCANNING_HOLD_RANGE | Open scanning for at most 24 hours. | |
| SCANNING_HOURS_NONE | Pause the session instead, or add scanning hours. | |
| SCANNING_SESSION_CHANGED | Fetch the session and send your change again. | |
| SCANNING_SESSION_CLOSED | Wait for the next opening, or open it for a while. | |
| SCANNING_SESSION_CONFIG_REQUIRED | Change the settings on the session, not on the device. | |
| SCANNING_SESSION_COUNTS_UNAVAILABLE | Retry with backoff. | |
| SCANNING_SESSION_MODE | Open the device in the session's mode. | |
| SCANNING_SESSION_NOT_FOUND | Check the session id. | |
| SCANNING_SESSION_OPEN | Do nothing; close it first to change how long it stays open. | |
| SCANNING_SESSION_PAUSED | Resume the session, then scan again. | |
| SCANNING_SESSION_SCOPE_INVALID | Correct the session's scope and settings, then add the device. | |
| SCANNING_SESSION_SETTINGS_INVALID | Correct the session's settings, then retry. | |
| SCAN_ACCESS_CHANGED | Reload the session and send the request again. | |
| SCAN_ADMIN_SETUP_REQUIRED | Choose the admin setup in the console, then retry. | |
| SCAN_BODY_INVALID | Send a JSON body with Content-Type: application/json. | |
| SCAN_CONFIG_CHANGED | Reload the scanner and scan again. | |
| SCAN_COUNTS_UNAVAILABLE | Retry with backoff. | |
| SCAN_CREDENTIAL_CHANGED | Reconnect the scanner so it picks up the new credential. | |
| SCAN_DISPLAY_PREVIEW_NOT_FOUND | Create the preview again and use its new id. | |
| SCAN_EVENT_CHANGED | Fetch the event with GET /api/v1/scan/events and send your change again. | |
| SCAN_EVENT_NOT_FOUND | Check the event id with GET /api/v1/scan/events. | |
| SCAN_EXPORT_RANGE | Export up to 92 days per request. | |
| SCAN_EXPORT_TOO_LARGE | Narrow the date range or filters and export in parts. | |
| SCAN_HISTORY_UNAVAILABLE | Retry with backoff. | |
| SCAN_IN_PROGRESS | Wait a moment and resend the identical request. | |
| SCAN_KEY_REUSED | Use a new unique request key for each action. | |
| SCAN_LIVE_ORIGIN | Open the screen on the PassBook site. | |
| SCAN_LOOKUP_DISABLED | Turn on lookup in the scanner's settings. | |
| SCAN_MARK_OUT_INVALID | Check who is inside, then mark out someone who is. | |
| SCAN_MODE_MISMATCH | Use a key and objects of the same mode. | |
| SCAN_NOT_FOUND | Check the scan id and the scanner's mode. | |
| SCAN_NO_SESSION | Assign the scanner to a session in the admin console. | |
| SCAN_OVERRIDE_FORBIDDEN | Do not retry; no one can let this person in. | |
| SCAN_OVERRIDE_INVALID | Override only scans that were refused for an overridable reason. | |
| SCAN_OVERRIDE_NOTE_CLOSED | Add the note when you override, not afterwards. | |
| SCAN_OVERRIDE_TAKEN | Do nothing; check the scan's history. | |
| SCAN_PASS_CHANGED | Scan the pass again. | |
| SCAN_SCOPE_NOT_ALLOWED | Leave out the scope; a paired scanner uses its own. | |
| SCAN_SCOPE_REQUIRED | Send orgId, or use a key scoped to one organization. | |
| SCAN_SEARCH_FORBIDDEN | Search by pass id or code, or sign in as an administrator. | |
| SCAN_SETTINGS_INVALID | Correct the settings named in issues, then retry. | |
| SCAN_SETUP_CONFLICT | Remove the template from the other session, or reuse that session. | |
| SCAN_STAFF_CHANGED | Fetch the staff list and send the request again. | |
| SCAN_STAFF_CURSOR | Drop the cursor and list again from the start. | |
| SCAN_STAFF_NOT_FOUND | Check the id with the scanner's staff list. | |
| SCAN_SUMMARY_SESSION_FORBIDDEN | Sign in with a manager PIN. | |
| SCAN_SURFACE_UNSUPPORTED | Use a screen device for displays. | |
| SCAN_TOO_MANY_MISSES | Wait a few minutes, then scan again. | |
| SCAN_TOO_MANY_OVERRIDES | Wait for the next hour, or ask a manager. | |
| SCAN_UNDO_EXPIRED | Correct the record by other means, such as marking the person out. | |
| SCAN_UNDO_FORBIDDEN | Ask a manager, or the operator who made the scan, to undo it. | |
| SCAN_WINDOW_INVALID | Set an end after the start, or fix the template's dates. | |
| SCREEN_ONLY | Use a scanner device for scanning. | |
| SCREEN_REQUIRED | Choose a screen view for the device in Scanning. | |
| SECRET_UNAVAILABLE | Rotate the secret with POST /api/v1/webhook-endpoints/{id}/secret, then send the request again. | |
| SERIAL_TAKEN | Send a different serial, or leave it out to have one generated. | |
| SESSION_OPEN_FORBIDDEN | Sign in with a manager PIN, then open it. | |
| SESSION_REQUIRED | Do it in the console, or sign in as the account that started it. | |
| SETTINGS_CHANGED | Fetch them with GET /api/v1/settings and send your change again. | |
| STAFF_NAME_REQUIRED | Send staffId with the PIN. | |
| STAFF_NAME_TAKEN | Choose a different name. | |
| STAFF_REQUIRED | Sign in with a staff PIN, then retry. | |
| STAFF_SIGN_IN_DISABLED | Turn on staff sign-in in the scanner's settings. | |
| STAFF_SIGN_IN_UNAVAILABLE | Pair the scanner, then sign in. | |
| STAMPS_ABOVE_MAX | Raise the template's stamp maximum, or redeem stamps first. | |
| STAMPS_CARD_FULL | Redeem the reward, then add stamps. | |
| STAMPS_NONE | Use a template with stamps. | |
| STAMPS_NO_REWARD | Add stamps until the card is full, then redeem. | |
| STAMPS_QUERY | Retry the request. | |
| STAMPS_REDRAW | Make the change in the template designer and publish a new version. | |
| TAGS_OFF | Turn on tags in the organization's settings. | |
| TAG_ALREADY_ASSIGNED | Fetch the tag and check its holder before reassigning. | |
| TAG_APPROVAL_REQUIRED | Have a manager approve it with their PIN. | |
| TAG_ASSIGN_FORBIDDEN | Turn on assigning in the scanner's settings, or sign in as Desk or above. | |
| TAG_ASSURANCE_LOW | Assign a secure tag type to the pass. | |
| TAG_CARD_AMBIGUOUS | Scan the card again, or assign the tag to a pass directly. | |
| TAG_CHECK_FAILED | Use a different tag. | |
| TAG_HOLDER_CHANGED | Fetch the tag and send the request again. | |
| TAG_ID_INVALID | Check the ID against the reader or the supplier's list. | |
| TAG_KEY_UNREADABLE | Retry once; if it persists, send the requestId to support. | |
| TAG_LIMIT | Release unused tags, or ask the platform owner to raise the limit. | |
| TAG_NOT_ASSIGNED | Assign the tag before this action. | |
| TAG_NOT_FOUND | Check the tag id. | |
| TAG_NO_ACCOUNT | Assign the tag to the pass instead. | |
| TAG_PASS_NOT_ACCEPTED | Add the pass's template or event to the scanner's session. | |
| TAG_POOL_UNSUPPORTED | Assign the tag to a pass or person instead. | |
| TAG_REQUEST_BUSY | Cancel the open request or wait for it to finish. | |
| TAG_REQUEST_EXPIRED | Create a new tag request. | |
| TAG_SCANNER_ONLY | Assign the tag from a paired scanner. | |
| TAG_SECURE_REQUIRED | Use a Secure (SUN) tag, or lower the session's tag level. | |
| TAG_SUN_REPLAY | Tap the tag again for a fresh read. | |
| TAG_SYSTEM_DISABLED | Pick a tag system that is available, or contact the platform owner. | |
| TAG_TYPED_OFF | Tap the tag on a scanner, or allow typed IDs on the tag type. | |
| TAG_TYPE_ARCHIVED | Restore the tag type or use another. | |
| TAG_TYPE_CHANGED | Fetch the tag type and send your change again. | |
| TAG_TYPE_CHOOSE | Send `typeId`, or set a default tag type for the organization. | |
| TAG_TYPE_LIMIT | Remove the pass's current tag of this type first, or use another type. | |
| TAG_TYPE_MISMATCH | Choose a tag type that lists this pass's template. | |
| TAG_TYPE_NAME_TAKEN | Choose a different name. | |
| TAG_TYPE_NOT_FOUND | Check the tag type id. | |
| TAG_TYPE_SCOPE | Choose a tag type with the scope you need. | |
| TAG_TYPE_SET | Leave `typeId` out, or change the tag's type in the console first. | |
| TAG_TYPE_SYSTEM | Choose a tag type for this tag's system. | |
| TAG_UID_RANDOM | Use a tag with a fixed ID. | |
| TAG_UNDO_EXPIRED | Add the tag again. | |
| TAG_UNDO_FORBIDDEN | Undo on that scanner, or have an admin remove the tag. | |
| TAG_UNREADABLE | Hold the tag steady, or use another tag. | |
| TAG_USE_MISMATCH | Choose a tag type whose use the template accepts. | |
| TEMPLATE_ARCHIVED | Restore it with POST /api/v1/templates/{id}/restore, or use another template. | |
| TEMPLATE_ASSET_CONFLICT | Upload the template version again. | |
| TEMPLATE_BAKED | Clone it with POST /api/v1/templates/{id}/clone and change the clone. | |
| TEMPLATE_BLUEPRINT_INACTIVE | Pick another. | |
| TEMPLATE_CANDIDATE_NOT_FOUND | Check the id with GET /api/v1/templates/{id}/candidates. | |
| TEMPLATE_CONFLICT | Fetch it with GET /api/v1/templates/{id} and send your change again. | |
| TEMPLATE_CONTENT_CHANGED | Send the request again to use the current release. | |
| TEMPLATE_EXISTS | Pick another name. | |
| TEMPLATE_IN_TAG_TYPE | Remove it from the type first. | |
| TEMPLATE_IN_USE | Remove it from them first. | |
| TEMPLATE_IS_BLUEPRINT | Use this blueprint to make one first. | |
| TEMPLATE_MODE_MISMATCH | Use a key of the template's mode. | |
| TEMPLATE_NOT_BLUEPRINT | Duplicate a template instead. | |
| TEMPLATE_NOT_FOUND | Check the id with GET /api/v1/templates and the key's mode. | |
| TEMPLATE_NOT_RELEASED | Release the template with POST /api/v1/templates/{id}/releases. | |
| TEMPLATE_NOT_SHAREABLE | Share an upload that no organization has taken. | |
| TEMPLATE_NOT_TESTED | Release it in Test first. | |
| TEMPLATE_ORG_REQUIRED | Assign the template to an organization, then retry. | |
| TEMPLATE_PROVIDER_UNSUPPORTED | Configure the provider for the organization, or release for another provider. | |
| TEMPLATE_RELEASE_CONFLICT | Send the request again to use the current release. | |
| TEMPLATE_RELEASE_NOT_FOUND | Check the id with GET /api/v1/templates/{id}/releases. | |
| TEMPLATE_RELEASE_REQUIRED | Approve a release with POST /api/v1/templates/{id}/candidates/{candidateId}/approve. | |
| TEMPLATE_SELF_APPROVAL | Have a different member approve the candidate. | |
| TEMPLATE_SLUG_CONFLICT | Send the request again, or choose a different name. | |
| TEMPLATE_USED_BY_OTHER_ORG | Reissue or delete them first. | |
| TEMPLATE_VERSION_CONFLICT | Fetch the template and publish again. | |
| TEMPLATE_VERSION_CONTENT_CONFLICT | Run the sync again. | |
| TEMPLATE_VERSION_NOT_FOUND | Check the version with GET /api/v1/templates/{id}. | |
| TERMINAL_NOT_FOUND | Use a terminal id from the key's terminals. | |
| TERMINAL_ONLY | Name one of the key's terminals in the device header. | |
| TERM_MANAGED | Change the term in the connected system. | |
| TERM_NONE | Renew only passes whose template defines a term. | |
| TERM_NOT_STARTED | Renew after the term starts. | |
| TEST_FORWARD_ALREADY_ATTEMPTED | Do not send it again; check your inbox first. | |
| TEST_FORWARD_CHANGED | Send it to yourself again. | |
| TEST_FORWARD_OUTCOME_UNKNOWN | Do not send this message again. | |
| TEST_FORWARD_PREPARATION_FAILED | Nothing was sent. | |
| TEST_KEY_REQUIRED | Use a key that starts with pb_test_. | |
| UNAUTHENTICATED | Send Authorization: Bearer $PASSBOOK_KEY. | |
| UNDO_SUPERSEDED | Undo the latest scan instead. | |
| UNDO_UNCONFIRMED | Check the scan's state, then retry once; if it persists, send the requestId to support. | |
| UNKNOWN_TEMPLATE | Use template ids from GET /api/v1/templates. | |
| UNLOCK_REQUIRED | Enter a staff PIN. | |
| UNSAFE_URL | Use a public https URL. | |
| UPLOAD_NOT_FOUND | Check the id with GET /api/v1/templates/uploads. | |
| USER_NOT_FOUND | Check the id with GET /api/v1/users. | |
| VALIDATION | Fix each field in issues and resend. | |
| VERSION_CONFLICT | GET the pass, apply your change to it, and resend with the new version. | |
| VERSION_INVALID | Use a version number from GET /api/v1/templates/{id}. | |
| VERSION_NOT_FOUND | Check the version with GET /api/v1/passes/{id}. | |
| VERSION_PURGED | Request a newer version. | |
| VISITOR_CHANGED | Fetch the visitor list with GET /api/v1/visitors and send your change again. | |
| VISITOR_HOST_NOTICE_FAILED | Send the request again; the visit is still recorded. | |
| VISITOR_HOST_UNKNOWN | Choose a host from GET /api/v1/visitors/hosts. | |
| VISITOR_IN | Check them out first. | |
| VISITOR_NOT_FOUND | Check the id with GET /api/v1/visitors. | |
| VISITOR_NOT_IN | Check them in before this action. | |
| VISITOR_OUT | Do nothing; check status with GET /api/v1/visitors. | |
| VISITOR_RESEND_LIMIT | Contact the host another way. | |
| VISITOR_TEMPLATE_MISSING | Set up the visitor template in the console, then retry. | |
| WALLET_ACCOUNT_CONFLICT | Fetch it again and send your change. | |
| WALLET_ACCOUNT_INSTANCES_ACTIVE | Retire all provider instances, then revoke the account. | |
| WALLET_ACCOUNT_MOVED | List accounts with GET /api/v1/wallet-providers/accounts and use the current one. | |
| WALLET_ART_MISMATCH | Replace the image with one at the size shown in issues. | |
| WALLET_CREDENTIALS_INVALID | Fix the credentials named in issues and send them again. | |
| WALLET_CREDENTIALS_UNAVAILABLE | Retry with backoff. | |
| WALLET_ENROLMENT_HELD | Ask the platform owner to release the hold. | |
| WALLET_ENROLMENT_PREREQUISITE | Finish the steps listed in the response, then retry. | |
| WALLET_IDENTITY_IMMUTABLE | Create a new account for the new identity. | |
| WALLET_IMAGE_NOT_FOUND | Rebuild the wallet projection and use the new image URL. | |
| WALLET_ISSUER_CLAIMED | Use a different issuer. | |
| WALLET_ISSUER_EXISTS | Attach it as a shared issuer instead. | |
| WALLET_ISSUER_NOT_WAITING | Check the issuer status before completing it. | |
| WALLET_KEY_HELD | Move the credential to the new key, then send the request again. | |
| WALLET_MODE_MISMATCH | Use a key of the same mode as the request. | |
| WALLET_OFFER_NOT_FOUND | Request a new offer for the pass. | |
| WALLET_PLATFORM_CREDENTIAL_MISSING | Ask the platform owner to add it, then send the request again. | |
| WALLET_PROJECTION_BLOCKED | Fix the problems the response lists and build the projection again. | |
| WALLET_PROJECTION_CONFLICT | Fetch the candidate again and send your request. | |
| WALLET_PROJECTION_NOT_FOUND | Check the id and create a candidate if it expired. | |
| WALLET_PROJECTION_SCHEMA | Create a new candidate from the current release. | |
| WALLET_PROJECTION_UNSUPPORTED | Remove the unsupported features or release without this provider. | |
| WALLET_RUN_BUSY | Send the request again in a minute. | |
| WALLET_VERIFICATION_CONFLICT | Wait for it to finish, then verify again if needed. | |
| WEBHOOK_ALREADY_FINISHED | Do nothing; check its status with GET /api/v1/connections/{id}/webhook-failures. | |
| WEBHOOK_CAPTURE_NOT_FOUND | List the endpoint's captures with GET /api/v1/webhook-endpoints/{id}/captures. | |
| WEBHOOK_CONTEXT_CONFLICT | Resend the event from the source system. | |
| WEBHOOK_DISPATCH_INCOMPLETE | Retry with backoff. | |
| WEBHOOK_EFFECT_UNCERTAIN | Resolve it with POST /api/v1/connections/{id}/webhook-failures/{retentionId}/resolve after checking the pass. | |
| WEBHOOK_ENDPOINT_LIMIT | Delete one first. | |
| WEBHOOK_ENDPOINT_NOT_FOUND | Check the id with GET /api/v1/webhook-endpoints. | |
| WEBHOOK_ENQUEUE_FAILED | Retry with backoff. | |
| WEBHOOK_ITEM_BUSY | Retry with backoff. | |
| WEBHOOK_ITEM_PENDING | Retry with backoff. | |
| WEBHOOK_NOTHING_TO_RESOLVE | Do nothing; list failures with GET /api/v1/connections/{id}/webhook-failures. | |
| WEBHOOK_NOT_FOUND | Check the retentionId with GET /api/v1/connections/{id}/webhook-failures. | |
| WEBHOOK_PAYLOAD | Send the body in the format the connector documents. | |
| WEBHOOK_PAYLOAD_MISSING | Retry with backoff; if it persists, resend the event from the source. | |
| WEBHOOK_REFERENCE_MODE | Retry with backoff. | |
| WEBHOOK_REFERENCE_MODE_CHANGED | Resend the event from the source system. | |
| WEBHOOK_RESOLVE_CONFLICT | List failures again and resolve once more. | |
| WEBHOOK_RETENTION_FAILED | Retry with backoff. | |
| WEBHOOK_RETENTION_UNAVAILABLE | Retry with backoff. | |
| WEBHOOK_SIGNATURE | Sign the body with the connection's current webhook secret. | |
| WEBHOOK_SNAPSHOT_UNAVAILABLE | Resend the event from the source system instead of replaying. | |
| WEBHOOK_STALE_CONTEXT | Resend the event from the source system. | |
| WEBHOOK_STILL_PENDING | Wait for it to run before resolving it. | |
| WEBHOOK_UNAVAILABLE | Retry the webhook. | |
| WEBHOOK_WORK_CHANGED | Retry with backoff. | |
| WORKFLOW_START | Send the request again. | |
| ZONE_ARCHIVED | Use a zone that is not archived. | |
| ZONE_CYCLE | Choose a parent outside the zone. | |
| ZONE_DEPTH | Move the zone higher in the tree. | |
| ZONE_EVENT_SESSION | Use a zone session, or remove the zones. | |
| ZONE_KEY_TAKEN | Choose a different key. | |
| ZONE_NAME_TAKEN | Choose a different name. | |
| ZONE_NOT_FOUND | Check the zone id. |