> ## Documentation Index
> Fetch the complete documentation index at: https://www.seam.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Unmanaged Errors and Warnings

> Unmanaged errors and warnings in the Seam API, with code meanings and example objects for diagnosing integration issues.

## Errors

Each error is an object with the following shape:

```json Example error theme={"dark"}
{
  "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": []
}
```

> [accordion] Error object properties
>
> **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.

### `access_not_provisioned`

Indicates that the access system rejected the access that Seam tried to set up for this access grant, so its credentials cannot open the affected entrances. For example, a hotel room may already be reserved or checked in for another guest. The message contains the reason that the access system gave. Seam keeps retrying, and this error clears automatically once the access system accepts the access.

***

### `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:

```json Example warning theme={"dark"}
{
  "warning_code": "being_deleted",
  "message": "Indicates that the access grant is being deleted.",
  "created_at": "2025-01-01T00:00:00.000Z"
}
```

> [accordion] Warning object properties
>
> **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\_id** `String (UUID)`
>
> ID of the access method whose requested code was unavailable. Present when an access system, such as Salto KS, assigned a different code.
>
> **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. Present when the code was set directly on a device.
>
> **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.

### `access_revoked`

Indicates that one of this access grant's access methods no longer grants access because of a change outside Seam, for example its card was encoded again for another credential. Seam does not replace the access method; issue a new one if the user still needs it.

***

### `being_deleted`

Indicates that the [access grant](https://www.seam.co/docs/use-cases/granting-access.md) 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 could not be used, so a different code was assigned. For example, the code was already in use on a device, or the access system rejected it because it did not meet its PIN rules.

***

### `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](https://www.seam.co/docs/use-cases/granting-access.md) are being updated.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.