---
title: "Event - Request Format"
description: ""
url: "https://docs.itrsgroup.com/docs/opsview/6.11.7/rest-api/event/api-events-request-format/index.html"
---
URL: `/rest/event`

This requires authentication. Requires VIEWALL or VIEWSOME permission.

- `GET` — returns event data for requested objects.
- `POST`, `PUT`, `DELETE` — not implemented.

An event is considered to be either:

- a host or service changing state (eg, from OK to CRITICAL).
- a host or service result during soft failures (eg, CRITICAL SOFT 1 to CRITICAL SOFT 2).
- a host or service in a failure state where alert every failure is enabled (seen as "volatile" in the API output).
- an acknowledgement.
- a downtime start.
- a downtime stop (or cancel).

## Access Control

- VIEWALL allows all event data to be returned.
- VIEWSOME allows event data to be returned for objects where permission has been granted for the service based on the access object selection.

## Troubleshooting

If you experience slow response times from this API, you can override the default `straight_join_num_objects_threshold` value by adding the following configuration to your user variables in Opsview Deploy and running the `orchestrator_install` playbook.

Lowering the threshold can help improve performance

```
opsview_core_web_local_overrides:
  Controller::REST::Event:
    straight_join_num_objects_threshold: 5000
```


