Akiles: access codes fail with "requires N-digit PINs"

Last updated

Symptom

An access code on an Akiles lock never reaches set, and shows code_constraints_violated with a message like "This lock's Akiles organization requires 4-digit PINs, so this code's PIN can't be set."

Cause

In Akiles, each organization can require PINs of a fixed length (Akiles Admin Panel → Settings). Akiles rejects any PIN of another length. Seam can't read this setting through the Akiles API.

Fix

  1. Delete the failed access code and create it again with a PIN of the required length, or leave out code and let Seam generate one.

  2. To have Seam enforce the length from now on, report it for each device:

    Text
    1POST /access_codes/report_device_constraints
    2{
    3  "device_id": "<device_id>",
    4  "supported_code_lengths": [4]
    5}

    After the next sync, Seam generates PINs at that length, and /access_codes/create rejects any other length with a 400 instead of creating a code that can't be set.

If you still have issues, reach out to Seam support.

Backup access codes and ACS credentials are not affected, because Akiles generates those PINs at the organization's length.

More in Connecting Your Devices

Still need help? Our support team will take a look.

Smart Locks
Access Systems
Lock Capabilities
Thermostats
Sensors
© 2026 Seam Labs, Inc.