Access Grant Errors and Warnings

Errors

Each error is an object with the following shape:

Example error

{
  "error_code": "cannot_create_requested_access_methods",
  "message": "Indicates that Seam could not create one or more of the requested access methods for the access grant.",
  "created_at": "2025-01-01T00:00:00.000Z",
  "missing_device_ids": []
}

Error object properties

Enum (String)

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.One of the error codes listed below.

String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

String (ISO 8601)

Date and time at which Seam created the error.

Array

IDs of the devices that did not receive an access code at grant creation. Use these to identify which specific devices failed when the message reports a partial failure.

`cannot_create_requested_access_methods`

Indicates that Seam could not create one or more of the requested access methods for the access grant.

Warnings

Each warning is an object with the following shape:

Example warning

{
  "warning_code": "being_deleted",
  "message": "Indicates that the access grant is being deleted.",
  "created_at": "2025-01-01T00:00:00.000Z"
}

Warning object properties

Enum (String)

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.One of the warning codes listed below.

String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

String (ISO 8601)

Date and time at which Seam created the warning.

Array

IDs of the access methods being updated.

String (UUID)

ID of the device where the requested code was unavailable.

Array

Devices whose access codes could not be revoked during reconciliation. Present when the provider does not support revoking an offline access code (e.g. Dormakaba oracode with exhausted override budget).

String

The new PIN code that was assigned instead.

String

The originally requested PIN code that was unavailable.

Enum (String)

Specific reason why the grant’s times are not programmable on the device.

`being_deleted`

Indicates that the access grant is being deleted.

`device_does_not_support_access_codes`

Indicates that a device in the access grant does not support access codes and was excluded from code materialization.

`device_time_constraints_violated`

Indicates that a device in the access grant cannot program an access code for the grant’s time range because of device-specific time constraints.

`overprovisioned_access`

Indicates that the access grant has access to locations it should not have. Access methods are being removed from the extra locations.

`requested_code_unavailable`

Indicates that the requested PIN code was already in use on a device, so a different code was assigned.

`underprovisioned_access`

Indicates that the access grant should have access to more locations than it currently does. Access methods are being created for the missing locations.

`updating_access_times`

Indicates that the access times for this access grant are being updated.

Getting Started

Granting Access

Devices and Systems

Setup

Monitoring

Low-Level APIs

Access Grant Errors and Warnings

Errors

`cannot_create_requested_access_methods`

Warnings

`being_deleted`

`device_does_not_support_access_codes`

`device_time_constraints_violated`

`overprovisioned_access`

`requested_code_unavailable`

`underprovisioned_access`

`updating_access_times`

​Errors

​cannot_create_requested_access_methods

​Warnings

​being_deleted

​device_does_not_support_access_codes

​device_time_constraints_violated

​overprovisioned_access

​requested_code_unavailable

​underprovisioned_access

​updating_access_times

Errors

`cannot_create_requested_access_methods`

Warnings

`being_deleted`

`device_does_not_support_access_codes`

`device_time_constraints_violated`

`overprovisioned_access`

`requested_code_unavailable`

`underprovisioned_access`

`updating_access_times`