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

# The Action Attempt Object

> Learn how the action_attempt object tracks an attempt to perform an action against a device, letting you monitor its status and final result.

## The action\_attempt Object

* [Properties](#properties)
* [Events](#events)

Represents an attempt to perform an action against a device.

***

## Properties

**`action_attempt_id`** *UUID*

ID of the action attempt.

***

**`status`** *Enum*

Status of the action attempt.

<details>
  <summary>Enum values</summary>

  * <code>pending</code>
  * <code>success</code>
  * <code>error</code>
</details>

***

**`action_type`** *Enum*

Type of the action attempt.

<details>
  <summary>Enum values</summary>

  * <code>LOCK\_DOOR</code>
  * <code>UNLOCK\_DOOR</code>
  * <code>SCAN\_CREDENTIAL</code>
  * <code>ENCODE\_CREDENTIAL</code>
  * <code>RESET\_SANDBOX\_WORKSPACE</code>
  * <code>SET\_FAN\_MODE</code>
  * <code>SET\_HVAC\_MODE</code>
  * <code>ACTIVATE\_CLIMATE\_PRESET</code>
  * <code>SIMULATE\_KEYPAD\_CODE\_ENTRY</code>
  * <code>SIMULATE\_MANUAL\_LOCK\_VIA\_KEYPAD</code>
  * <code>PUSH\_THERMOSTAT\_PROGRAMS</code>
  * <code>CONFIGURE\_AUTO\_LOCK</code>
</details>

***

**`error`** *Object*

Error associated with the action attempt. Null for pending and successful action attempts.

***

**`result`** *Object*

Result of the action attempt. Null for pending and errored action attempts.

***

## Events

**`action_attempt.lock_door.succeeded`**

A lock door [action attempt](/core-concepts/action-attempts) succeeded.

<details>
  <summary>Properties</summary>

  <strong>
    <code>action\_attempt\_id</code>
  </strong>

  <i>UUID</i>

  ID of the affected action attempt.

  <strong>
    <code>action\_type</code>
  </strong>

  <i>String</i>

  Type of the action.

  <strong>
    <code>connected\_account\_id</code>
  </strong>

  <i>UUID</i>

  ID of the connected account associated with the action attempt, if applicable.

  <strong>
    <code>created\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event was created.

  <strong>
    <code>device\_id</code>
  </strong>

  <i>UUID</i>

  ID of the device associated with the action attempt, if applicable.

  <strong>
    <code>event\_id</code>
  </strong>

  <i>UUID</i>

  ID of the event.

  <strong>
    <code>event\_type</code>
  </strong>

  <i>Enum</i>

  Value: `action_attempt.lock_door.succeeded`

  <strong>
    <code>occurred\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event occurred.

  <strong>
    <code>status</code>
  </strong>

  <i>String</i>

  Status of the action.

  <strong>
    <code>workspace\_id</code>
  </strong>

  <i>UUID</i>

  ID of the [workspace](/core-concepts/workspaces) associated with the event.
</details>

***

**`action_attempt.lock_door.failed`**

A lock door [action attempt](/core-concepts/action-attempts) failed.

<details>
  <summary>Properties</summary>

  <strong>
    <code>action\_attempt\_id</code>
  </strong>

  <i>UUID</i>

  ID of the affected action attempt.

  <strong>
    <code>action\_type</code>
  </strong>

  <i>String</i>

  Type of the action.

  <strong>
    <code>connected\_account\_id</code>
  </strong>

  <i>UUID</i>

  ID of the connected account associated with the action attempt, if applicable.

  <strong>
    <code>created\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event was created.

  <strong>
    <code>device\_id</code>
  </strong>

  <i>UUID</i>

  ID of the device associated with the action attempt, if applicable.

  <strong>
    <code>event\_id</code>
  </strong>

  <i>UUID</i>

  ID of the event.

  <strong>
    <code>event\_type</code>
  </strong>

  <i>Enum</i>

  Value: `action_attempt.lock_door.failed`

  <strong>
    <code>occurred\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event occurred.

  <strong>
    <code>status</code>
  </strong>

  <i>String</i>

  Status of the action.

  <strong>
    <code>workspace\_id</code>
  </strong>

  <i>UUID</i>

  ID of the [workspace](/core-concepts/workspaces) associated with the event.
</details>

***

**`action_attempt.unlock_door.succeeded`**

An unlock door [action attempt](/core-concepts/action-attempts) succeeded.

<details>
  <summary>Properties</summary>

  <strong>
    <code>action\_attempt\_id</code>
  </strong>

  <i>UUID</i>

  ID of the affected action attempt.

  <strong>
    <code>action\_type</code>
  </strong>

  <i>String</i>

  Type of the action.

  <strong>
    <code>connected\_account\_id</code>
  </strong>

  <i>UUID</i>

  ID of the connected account associated with the action attempt, if applicable.

  <strong>
    <code>created\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event was created.

  <strong>
    <code>device\_id</code>
  </strong>

  <i>UUID</i>

  ID of the device associated with the action attempt, if applicable.

  <strong>
    <code>event\_id</code>
  </strong>

  <i>UUID</i>

  ID of the event.

  <strong>
    <code>event\_type</code>
  </strong>

  <i>Enum</i>

  Value: `action_attempt.unlock_door.succeeded`

  <strong>
    <code>occurred\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event occurred.

  <strong>
    <code>status</code>
  </strong>

  <i>String</i>

  Status of the action.

  <strong>
    <code>workspace\_id</code>
  </strong>

  <i>UUID</i>

  ID of the [workspace](/core-concepts/workspaces) associated with the event.
</details>

***

**`action_attempt.unlock_door.failed`**

An unlock door [action attempt](/core-concepts/action-attempts) failed.

<details>
  <summary>Properties</summary>

  <strong>
    <code>action\_attempt\_id</code>
  </strong>

  <i>UUID</i>

  ID of the affected action attempt.

  <strong>
    <code>action\_type</code>
  </strong>

  <i>String</i>

  Type of the action.

  <strong>
    <code>connected\_account\_id</code>
  </strong>

  <i>UUID</i>

  ID of the connected account associated with the action attempt, if applicable.

  <strong>
    <code>created\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event was created.

  <strong>
    <code>device\_id</code>
  </strong>

  <i>UUID</i>

  ID of the device associated with the action attempt, if applicable.

  <strong>
    <code>event\_id</code>
  </strong>

  <i>UUID</i>

  ID of the event.

  <strong>
    <code>event\_type</code>
  </strong>

  <i>Enum</i>

  Value: `action_attempt.unlock_door.failed`

  <strong>
    <code>occurred\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event occurred.

  <strong>
    <code>status</code>
  </strong>

  <i>String</i>

  Status of the action.

  <strong>
    <code>workspace\_id</code>
  </strong>

  <i>UUID</i>

  ID of the [workspace](/core-concepts/workspaces) associated with the event.
</details>

***

**`action_attempt.simulate_keypad_code_entry.succeeded`**

A simulate keypad code entry [action attempt](/core-concepts/action-attempts) succeeded.

<details>
  <summary>Properties</summary>

  <strong>
    <code>action\_attempt\_id</code>
  </strong>

  <i>UUID</i>

  ID of the affected action attempt.

  <strong>
    <code>action\_type</code>
  </strong>

  <i>String</i>

  Type of the action.

  <strong>
    <code>connected\_account\_id</code>
  </strong>

  <i>UUID</i>

  ID of the connected account associated with the action attempt, if applicable.

  <strong>
    <code>created\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event was created.

  <strong>
    <code>device\_id</code>
  </strong>

  <i>UUID</i>

  ID of the device associated with the action attempt, if applicable.

  <strong>
    <code>event\_id</code>
  </strong>

  <i>UUID</i>

  ID of the event.

  <strong>
    <code>event\_type</code>
  </strong>

  <i>Enum</i>

  Value: `action_attempt.simulate_keypad_code_entry.succeeded`

  <strong>
    <code>occurred\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event occurred.

  <strong>
    <code>status</code>
  </strong>

  <i>String</i>

  Status of the action.

  <strong>
    <code>workspace\_id</code>
  </strong>

  <i>UUID</i>

  ID of the [workspace](/core-concepts/workspaces) associated with the event.
</details>

***

**`action_attempt.simulate_keypad_code_entry.failed`**

A simulate keypad code entry [action attempt](/core-concepts/action-attempts) failed.

<details>
  <summary>Properties</summary>

  <strong>
    <code>action\_attempt\_id</code>
  </strong>

  <i>UUID</i>

  ID of the affected action attempt.

  <strong>
    <code>action\_type</code>
  </strong>

  <i>String</i>

  Type of the action.

  <strong>
    <code>connected\_account\_id</code>
  </strong>

  <i>UUID</i>

  ID of the connected account associated with the action attempt, if applicable.

  <strong>
    <code>created\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event was created.

  <strong>
    <code>device\_id</code>
  </strong>

  <i>UUID</i>

  ID of the device associated with the action attempt, if applicable.

  <strong>
    <code>event\_id</code>
  </strong>

  <i>UUID</i>

  ID of the event.

  <strong>
    <code>event\_type</code>
  </strong>

  <i>Enum</i>

  Value: `action_attempt.simulate_keypad_code_entry.failed`

  <strong>
    <code>occurred\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event occurred.

  <strong>
    <code>status</code>
  </strong>

  <i>String</i>

  Status of the action.

  <strong>
    <code>workspace\_id</code>
  </strong>

  <i>UUID</i>

  ID of the [workspace](/core-concepts/workspaces) associated with the event.
</details>

***

**`action_attempt.simulate_manual_lock_via_keypad.succeeded`**

A simulate manual lock via keypad [action attempt](/core-concepts/action-attempts) succeeded.

<details>
  <summary>Properties</summary>

  <strong>
    <code>action\_attempt\_id</code>
  </strong>

  <i>UUID</i>

  ID of the affected action attempt.

  <strong>
    <code>action\_type</code>
  </strong>

  <i>String</i>

  Type of the action.

  <strong>
    <code>connected\_account\_id</code>
  </strong>

  <i>UUID</i>

  ID of the connected account associated with the action attempt, if applicable.

  <strong>
    <code>created\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event was created.

  <strong>
    <code>device\_id</code>
  </strong>

  <i>UUID</i>

  ID of the device associated with the action attempt, if applicable.

  <strong>
    <code>event\_id</code>
  </strong>

  <i>UUID</i>

  ID of the event.

  <strong>
    <code>event\_type</code>
  </strong>

  <i>Enum</i>

  Value: `action_attempt.simulate_manual_lock_via_keypad.succeeded`

  <strong>
    <code>occurred\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event occurred.

  <strong>
    <code>status</code>
  </strong>

  <i>String</i>

  Status of the action.

  <strong>
    <code>workspace\_id</code>
  </strong>

  <i>UUID</i>

  ID of the [workspace](/core-concepts/workspaces) associated with the event.
</details>

***

**`action_attempt.simulate_manual_lock_via_keypad.failed`**

A simulate manual lock via keypad [action attempt](/core-concepts/action-attempts) failed.

<details>
  <summary>Properties</summary>

  <strong>
    <code>action\_attempt\_id</code>
  </strong>

  <i>UUID</i>

  ID of the affected action attempt.

  <strong>
    <code>action\_type</code>
  </strong>

  <i>String</i>

  Type of the action.

  <strong>
    <code>connected\_account\_id</code>
  </strong>

  <i>UUID</i>

  ID of the connected account associated with the action attempt, if applicable.

  <strong>
    <code>created\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event was created.

  <strong>
    <code>device\_id</code>
  </strong>

  <i>UUID</i>

  ID of the device associated with the action attempt, if applicable.

  <strong>
    <code>event\_id</code>
  </strong>

  <i>UUID</i>

  ID of the event.

  <strong>
    <code>event\_type</code>
  </strong>

  <i>Enum</i>

  Value: `action_attempt.simulate_manual_lock_via_keypad.failed`

  <strong>
    <code>occurred\_at</code>
  </strong>

  <i>Datetime</i>

  Date and time at which the event occurred.

  <strong>
    <code>status</code>
  </strong>

  <i>String</i>

  Status of the action.

  <strong>
    <code>workspace\_id</code>
  </strong>

  <i>UUID</i>

  ID of the [workspace](/core-concepts/workspaces) associated with the event.
</details>

***

## Endpoints

[**`/action_attempts/get`**](./get)

Returns a specified [action attempt](/core-concepts/action-attempts).

[**`/action_attempts/list`**](./list)

Returns a list of the [action attempts](/core-concepts/action-attempts) that you specify as an array of `action_attempt_id`s.