# Events & Actions

When registering with Attuitive, your workspace is given 100,000 **API Events** & 150 **Intelligence Actions** each month as usage. These are recorded as you use both the API & Console.

> **Important:** When usage limits are reached it is **not** possible to make further changes or generations. Attempts will return error responses with a `403` status code and clear error message indicating this.

## API Events

**API Events** are actions taken within Attuitive and recorded for your workspace. In general, when data is modified in some way this would be recorded as an **Event**.

For example, if a user's [identifiers or traits](/attuitive/basics/identifiers-and-traits.md) are modified this would be recorded as a single **Event**. Similarly, if a [user distillation](/attuitive/api-reference/distill.md) is generated this would also record as a single **Event**.

## Intelligence Actions

**Intelligence Actions** are events that use Attuitive's intelligence framework to transform data into insights - such as [user distillations](/attuitive/api-reference/distill.md). A single transformation would be recorded as a single **Intelligence Action**.

## Viewing usage

The usage of a workspace can be viewed via the [customer portal](https://polar.sh/attuitive/portal). This can be accessed from the [Attuitive Console](https://console.attuitive.com/app) by navigating to **Settings > Billing**. You may be asked to verify your email, once done so usage can be viewed under the **Usage** section.

<figure><img src="/files/aMMbsz2DrAjZ1ge7lz81" alt=""><figcaption><p>Usage in the customer portal</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tristans-organization-4.gitbook.io/attuitive/basics/events-and-actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
