# Action Attempts

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

* `pending`
* `success`
* `error`

</details>

***

**`action_type`** *Enum*

Type of the action attempt.

<details>

<summary>Enum values</summary>

* `LOCK_DOOR`
* `UNLOCK_DOOR`
* `SCAN_CREDENTIAL`
* `ENCODE_CREDENTIAL`
* `RESET_SANDBOX_WORKSPACE`
* `SET_FAN_MODE`
* `SET_HVAC_MODE`
* `ACTIVATE_CLIMATE_PRESET`
* `SIMULATE_KEYPAD_CODE_ENTRY`
* `SIMULATE_MANUAL_LOCK_VIA_KEYPAD`
* `PUSH_THERMOSTAT_PROGRAMS`

</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](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/action-attempts) succeeded.

<details>

<summary>Properties</summary>

**`action_attempt_id`** *UUID*

ID of the affected action attempt.

**`action_type`** *String*

Type of the action.

**`created_at`** *Datetime*

Date and time at which the event was created.

**`event_id`** *UUID*

ID of the event.

**`event_type`** *Enum*

Value: `action_attempt.lock_door.succeeded`

**`occurred_at`** *Datetime*

Date and time at which the event occurred.

**`status`** *String*

Status of the action.

**`workspace_id`** *UUID*

ID of the [workspace](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/workspaces) associated with the event.

</details>

***

**`action_attempt.lock_door.failed`**

A lock door [action attempt](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/action-attempts) failed.

<details>

<summary>Properties</summary>

**`action_attempt_id`** *UUID*

ID of the affected action attempt.

**`action_type`** *String*

Type of the action.

**`created_at`** *Datetime*

Date and time at which the event was created.

**`event_id`** *UUID*

ID of the event.

**`event_type`** *Enum*

Value: `action_attempt.lock_door.failed`

**`occurred_at`** *Datetime*

Date and time at which the event occurred.

**`status`** *String*

Status of the action.

**`workspace_id`** *UUID*

ID of the [workspace](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/workspaces) associated with the event.

</details>

***

**`action_attempt.unlock_door.succeeded`**

An unlock door [action attempt](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/action-attempts) succeeded.

<details>

<summary>Properties</summary>

**`action_attempt_id`** *UUID*

ID of the affected action attempt.

**`action_type`** *String*

Type of the action.

**`created_at`** *Datetime*

Date and time at which the event was created.

**`event_id`** *UUID*

ID of the event.

**`event_type`** *Enum*

Value: `action_attempt.unlock_door.succeeded`

**`occurred_at`** *Datetime*

Date and time at which the event occurred.

**`status`** *String*

Status of the action.

**`workspace_id`** *UUID*

ID of the [workspace](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/workspaces) associated with the event.

</details>

***

**`action_attempt.unlock_door.failed`**

An unlock door [action attempt](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/action-attempts) failed.

<details>

<summary>Properties</summary>

**`action_attempt_id`** *UUID*

ID of the affected action attempt.

**`action_type`** *String*

Type of the action.

**`created_at`** *Datetime*

Date and time at which the event was created.

**`event_id`** *UUID*

ID of the event.

**`event_type`** *Enum*

Value: `action_attempt.unlock_door.failed`

**`occurred_at`** *Datetime*

Date and time at which the event occurred.

**`status`** *String*

Status of the action.

**`workspace_id`** *UUID*

ID of the [workspace](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/workspaces) associated with the event.

</details>

***

## Endpoints

[**`/action_attempts/get`**](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/api/action_attempts/get)

Returns a specified [action attempt](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/action-attempts).

[**`/action_attempts/list`**](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/api/action_attempts/list)

Returns a list of the [action attempts](https://docs.seam.co/latest/~/revisions/WnT0iExlRmVG3JXMNm4C/core-concepts/action-attempts) that you specify as an array of `action_attempt_id`s.