v1

latestOpenAPI 3.0.02026-08-041326126.6 KB

Endpoints

Events

Security Events

This endpoint provides security events from Defender, Guardian, and Architect.

get/api/v1/events

Query parameters

created_afterstring date-time

Only include events that were created after this time.

limitinteger

The maximum number of events to return.

after_checkpointstring

If provided, this parameter must be set to the checkpoint returned by a previous request to this endpoint. When provided, events from the previous request will not be included in the response from this request. If the new checkpoint returned by this request is used in yet another call to this endpoint events from both previous requests will not be included in the response (and so on). By making a number of consecutive requests to this endpoint where the checkpoint from the previous request is provided, clients can get all events from the Tessian platform, even when there are many more than can be returned in a single request. This process is often referred to as pagination.

If an event is updated, it will no longer be excluded from subsequent requests.

Response

Success

checkpointstring required

This value can be provided to a subsequent request via the after_checkpoint query parameter to ensure that events from this request are not returned in future responses. This allows clients to paginate through results.

additional_resultsboolean required

True if there may be more events that can be immediately retrieved. Note that there may be times when additional_results is true, but when you make a subsequent call you receive back zero results.