Skip to main content

​
Errors

Each error is an object with the following shape:
Example error
{
  "error_code": "cannot_create_requested_access_methods",
  "message": "A human-readable message.",
  "created_at": "2025-01-01T00:00:00.000Z",
  "missing_device_ids": []
}
​
error_code
Enum (String)
Unique identifier of the type of error. Enables quick recognition and categorization of the issue.One of the error codes listed below.
​
message
String
Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
​
created_at
String (ISO 8601)
Date and time at which Seam created the error.
​
missing_device_ids
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 the cannot_create_requested_access_methods state.

​
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_code
Enum (String)
Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.One of the warning codes listed below.
​
message
String
Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
​
created_at
String (ISO 8601)
Date and time at which Seam created the warning.
​
access_method_ids
Array
IDs of the access methods being updated.
​
device_id
String (UUID)
ID of the device where the requested code was unavailable.
​
failed_devices
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).
​
new_code
String
The new PIN code that was assigned instead.
​
original_code
String
The originally requested PIN code that was unavailable.
​
reason
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.