> For the complete documentation index, see [llms.txt](https://api-reference.lassomoderation.com/llms.txt)

# Send user events

> POST /events
> 
> Send things your users do besides posting content, such as joining or leaving a channel,
> removing or blocking another user, or liking a piece of content. Events use the same
> category and subcategory as content (a room, channel, thread, post or conversation) and
> show up between the content in its context and in the user's content history, so
> moderators can see what happened around a message.
> 
> An event type is created the first time you send its `event.id`; a later request with a
> different `event.name` renames it. The number of event types is limited per plan (Free and
> Starter 3, Pro 5, Enterprise 20). Events of a new type that would go over the limit are
> rejected per item; the others are still stored. Delete event types you no longer send in
> **Settings → Events** to free a slot.
> 
> Events are stored asynchronously. Up to 100 events per request.
> 
> Default rate limit: 300 requests per minute.



## Servers
- Lasso Moderation API V1: https://api.lassomoderation.com/api/v1 (Lasso Moderation API V1)


## Authentication methods
- Bearer auth


## Parameters



### Body: application/json (object)

- **events** (array[object])
  Provide at least one of `user_id`, `target_user_id`, `content_id` or `category`.



## Responses
### 200
OK. At least one event was accepted; `rejected` lists the events that were not.

#### Body: application/json (object)
- **success** (boolean)

- **data** (object)


### 400
The request is invalid, see the error field for details

#### Body: application/json (object)
- **success** (boolean)

- **error** (string | object)
  A message describing the error. For validation errors this is an object with an error message per field.


### 401
The API token is missing or invalid

#### Body: application/json (object)
- **success** (boolean)

- **error** (string | object)
  A message describing the error. For validation errors this is an object with an error message per field.


### 422
Every event in the request was rejected because of the event type limit.

#### Body: application/json (object)
- **success** (boolean)

- **error** (object)


### 429
The rate limit has been exceeded, check the X-RateLimit headers for limits
#### Headers

- **X-RateLimit-Limit** ()
  The rate limit interval in milliseconds

- **X-RateLimit-Remaining** ()
  The number of requests remaining in the current interval

- **X-RateLimit-Reset** ()
  The number of milliseconds until requests are allowed again


#### Body: application/json (object)
- **error** (string)



[Powered by Bump.sh](https://bump.sh)
