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

# Events reference

> Event format, naming conventions, and the full list of event types.

## Event format

Events follow an `object.action` naming convention. The `data` field contains a summary of the resource at the time of the event.

```json theme={null}
{
  "id": "evt_a1b2c3d4...",
  "object": "event",
  "type": "credential.verified",
  "data": {
    "id": "cred_a1b2c3d4...",
    "object": "credential",
    "status": "verified",
    "source_id": "src_a1b2c3d4...",
    "auth_method": "username_password"
  },
  "created_at": "2025-01-15T09:30:00Z"
}
```

## Agent events

| Type            | Fired when          |
| --------------- | ------------------- |
| `agent.created` | An agent is created |
| `agent.updated` | An agent is updated |
| `agent.deleted` | An agent is deleted |

## Source events

| Type             | Fired when          |
| ---------------- | ------------------- |
| `source.created` | A source is created |
| `source.updated` | A source is updated |
| `source.deleted` | A source is deleted |

## Credential events

| Type                    | Fired when                                                                |
| ----------------------- | ------------------------------------------------------------------------- |
| `credential.created`    | A new credential is created with `unverified` status                      |
| `credential.unverified` | A previously verified credential was updated and reverted to `unverified` |
| `credential.verified`   | Credential successfully authenticated for the first time                  |
| `credential.invalid`    | Credentials were rejected by the source                                   |
| `credential.deleted`    | Credential was permanently removed from the vault                         |

## Session events

| Type                 | Fired when                                       |
| -------------------- | ------------------------------------------------ |
| `session.queued`     | Session is waiting to be provisioned             |
| `session.running`    | Session is active and executing                  |
| `session.idle`       | No active tasks, session is waiting for new work |
| `session.completing` | Work is done, session is shutting down           |
| `session.completed`  | Session finished and was closed                  |
| `session.failed`     | Session encountered an error                     |

## Task events

| Type           | Fired when                                                  |
| -------------- | ----------------------------------------------------------- |
| `task.created` | A task is created                                           |
| `task.updated` | A task definition is updated                                |
| `task.reset`   | A task is reset to `learning`, invalidating its cached plan |
| `task.deleted` | A task is deleted                                           |

## Task run events

| Type                            | Fired when                                                             |
| ------------------------------- | ---------------------------------------------------------------------- |
| `task_run.queued`               | Run is waiting to start                                                |
| `task_run.running`              | Execution begins                                                       |
| `task_run.completed`            | Run finishes successfully                                              |
| `task_run.failed`               | Run encounters an error                                                |
| `task_run.canceling`            | Cancellation requested, agent is stopping                              |
| `task_run.canceled`             | Run is canceled                                                        |
| `task_run.interaction_required` | User input is needed during execution                                  |
| `task_run.review_required`      | Run has finished execution and is waiting for review before completing |

## Storage events

| Type              | Fired when                         |
| ----------------- | ---------------------------------- |
| `storage.created` | A file is stored during a task run |

## Event destination events

| Type                            | Fired when                                           |
| ------------------------------- | ---------------------------------------------------- |
| `event_destination.activated`   | A destination passes verification and becomes active |
| `event_destination.deactivated` | A destination is disabled                            |

## User events

| Type           | Fired when                             |
| -------------- | -------------------------------------- |
| `user.created` | A user is created in your organization |