(NEW!) Event History

COMING SOON!

This endpoint returns a complete history of all events

SecurityApiKeyAuth or BasicAuth
Request
query Parameters
resourceId
string or null

The resourceId parameter can be used to filter response results based on a specific resource in Tenovos, such as the unique id of an Asset, Collection, Story Board, etc. When used to filter event history, only event types and events specifically associated to the resource 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 resource.

Example: resourceId=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. If not specified, the previous 12 months of events will be returned.

Format: Full datetime (YYYY-MM-DDTHH:mm:ssZ) for compatibility. Must be URL-encoded if using the full datetime.

Example: startDate=2024-10-12T15:27:59Z
endDate
string or null

The end of the date range for event history. If not specified, the previous 12 months of events will be returned.

Format: Full datetime (YYYY-MM-DDTHH:mm:ssZ) for compatibility. Must be URL-encoded if using the full datetime.

Example: endDate=2024-11-09T08:14:56Z
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/events/history
Request samples 
Response samples 
application/json
{
  • "total": 798054,
  • "pageSize": 100,
  • "nextCursor": "eyJvZmZzZXQiOjIwMH0",
  • "prevCursor": "kmFvYmBzZXQiOjIwNJ0",
  • "events": [
    ]
}