> For the complete documentation index, see [llms.txt](https://agpt.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://agpt.co/docs/integrations/block-integrations/websets_events.md).

# Exa Websets Events

Blocks for reading the event history Exa records for your Websets and Websets monitors.

## Exa Get Webset Event

### What it is

Get one Exa Websets event and the resource it is about

### How it works

This block fetches one event from the Websets API's `/v0/events/{id}` and returns its ID, type, time and the full resource it is about (a webset, item, search, import or monitor). Exa keeps events for 60 days.

It makes one request and does not wait or poll. It records no Exa cost, so it is not charged. It needs your own Exa API key and fails with a clear message on the platform's shared Exa key, since every user of that key shares one Exa account.

### Inputs

| Input     | Description        | Type | Required |
| --------- | ------------------ | ---- | -------- |
| event\_id | The event to fetch | str  | Yes      |

### Outputs

| Output      | Description                                                                    | Type            |
| ----------- | ------------------------------------------------------------------------------ | --------------- |
| error       | Error message if the operation failed                                          | str             |
| event\_id   | The event's ID                                                                 | str             |
| event\_type | e.g. webset.item.created                                                       | str             |
| created\_at | When it happened (ISO 8601)                                                    | str             |
| data        | The full resource the event is about (webset, item, search, import or monitor) | Dict\[str, Any] |
| event       | The full event                                                                 | Event           |

### Possible use case

**Webhook Follow-Up**: Look up the full event behind an event ID received from a webhook delivery.

**Delivery Debugging**: Fetch the event named in a failed webhook attempt to see what was not delivered.

**Item Inspection**: Read the webset item attached to a webset.item.created event.

***

## Exa List Webset Events

### What it is

List Exa Websets events (new items, finished searches, monitor runs and more) from the last 60 days

### How it works

This block lists events from the Websets API's `/v0/events`, newest first, from the last 60 days. Each selected type is sent as its own filter, and times without a timezone are treated as UTC. Each call returns one page of up to 200 events (25 by default); pass `next_cursor` back as `cursor` for the next page.

Selecting the legacy `import.processing` type makes the block fail with a message to use `import.completed`. It is a polling alternative to the Exa Webset Webhook trigger. It records no Exa cost, so it is not charged. It needs your own Exa API key and fails with a clear message on the platform's shared Exa key, since every user of that key shares one Exa account.

### Inputs

| Input           | Description                                             | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Required |
| --------------- | ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| types           | Only list these event types; leave empty for all        | List\["webset.created" \| "webset.deleted" \| "webset.paused" \| "webset.idle" \| "webset.search.created" \| "webset.search.canceled" \| "webset.search.completed" \| "webset.search.updated" \| "import.created" \| "import.completed" \| "import.processing" \| "webset.item.created" \| "webset.item.enriched" \| "webset.export.created" \| "webset.export.completed" \| "monitor.created" \| "monitor.updated" \| "monitor.deleted" \| "monitor.run.created" \| "monitor.run.completed"] | No       |
| created\_after  | Only events at or after this time (UTC if no timezone)  | str (date-time)                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | No       |
| created\_before | Only events at or before this time (UTC if no timezone) | str (date-time)                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | No       |
| limit           | Events per page (1-200)                                 | int                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | No       |
| cursor          | Cursor from a previous page's next\_cursor              | str                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | No       |

### Outputs

| Output       | Description                           | Type                    |
| ------------ | ------------------------------------- | ----------------------- |
| error        | Error message if the operation failed | str                     |
| events       | Events on this page                   | List\[WebsetEventModel] |
| event        | Each event, one at a time             | Event                   |
| has\_more    | Whether another page exists           | bool                    |
| next\_cursor | Pass as cursor to fetch the next page | str                     |

### Possible use case

**Scheduled Polling**: Check every hour for new webset.item.created events and process the new items.

**Activity Log**: Collect all events from the past week into a sheet or report.

**Missed Event Recovery**: Replay events from a time window when a webhook endpoint was down.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://agpt.co/docs/integrations/block-integrations/websets_events.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
