(NEW!) Event History

COMING SOON!

This endpoint returns a complete history of all events

SecurityApiKeyAuth or BasicAuth
Request
query Parameters
assetId
string or null

The assetId parameter can be used to filter response results based on a specific Asset in Tenovos. When used to filter event history, only event types and events specifically associated to the Asset ID provided will be returned. This mean event types such as user.created, security.template.created, etc., will be filtered out any time this parameter is provided.

A 36-character UUID representing the asset.

Example: assetId=b84ac1dc-30ed-4741-8f8d-47ef2635950b
userId
string or null

The userId parameter can be used to filter response results based on a specific User in Tenovos. When used to filter event history, only events specifically associated to the User ID provided will be returned.

A 36-character UUID representing the User.

Example: userId=cd0caff5-2756-4d7c-a43d-a926a81fa9b8
eventType
string or null

The event type parameter can be used to filter response results based on the type of event. For a full list of available types, please refer to the Event Types page for an up-to-date list of available values.

Example: eventType=asset.created
startDate
string or null

The start of the date range for event history.

Format: ISO 8601 date (YYYY-MM-DD) or full datetime (YYYY-MM-DDTHH:mm:ssZ) for compatibility. Must be URL-encoded if using the full datetime.

Example: startDate=2024-10-12
endDate
string or null

The end of the date range for event history.

Format: ISO 8601 date (YYYY-MM-DD) or full datetime (YYYY-MM-DDTHH:mm:ssZ) for compatibility. Must be URL-encoded if using the full datetime.

Example: endDate=2024-12-12
pageSize
number or null

The pageSize parameter can be used to limit the response results for each request. When used for event history, the minimum recommended pageSize is 100. Based on the limiting scope of your query parameters, pageSize can be increased to 1000.

Example: pageSize=500
cursor
string or null

Provides the cursor for the next result set. Can be either the response value for nextCursor or prevCursor depending on the desired pagination direction.

Example: cursor=eyJvZmZzZXQiOjIwMH0
Responses
200

Successful Request. Event Types Retrieved Successfully.

400

One or more required parameters are missing or invalid.

401

Authentication failed (unauthorized).

403

Forbidden. You do not have permissions to perform this action, or your connection information is not correct.

503

The server is too busy to handle the request.

get/webhooks/events/history
Request samples 
Response samples 
application/json
{
  • "total": 798054,
  • "pageSize": 100,
  • "nextCursor": "eyJvZmZzZXQiOjIwMH0",
  • "prevCursor": "kmFvYmBzZXQiOjIwNJ0",
  • "events": [
    ]
}