We're excited to announce the addition of comprehensive audit query endpoints to the API. These new endpoints provide programmatic access to your organization's audit logs, enabling better security monitoring, compliance reporting, and operational visibility.

Key Features

The new audit endpoints support:

  • Flexible Filtering: Query audit events by date range, user, event type, and HTTP status code
  • Project and Account Scoping: Access audit data within your security boundaries
  • Pagination Support: Efficiently retrieve large datasets with configurable page sizes
  • Comprehensive Event Data: Each audit event includes detailed information about the request, response, user context, and more

API Endpoints

Two new endpoints are now available in the v2 API:

Get Audit Events

GET /v2/Audit

Query parameters:

  • FromDate / ToDate: Filter by date range
  • UserId: Filter by specific user
  • EventType: Filter by event type
  • StatusCode: Filter by HTTP status code
  • Skip / Take: Pagination controls (max 100 records per request)

Get Audit Event by ID

GET /v2/Audit/{id}

Retrieve detailed information about a specific audit event.

Example Event Types

As part of this release, we've also improved our audit event categorization. Instead of generic "HttpRequest" events, you'll now see descriptive event types like:

  • Instance.Create - When a new instance is provisioned
  • Account.Update - When account details are modified
  • Metal.List - When bare metal resources are queried

These human-readable event types make it easier to filter and understand audit activity at a glance.

Getting Started

To begin using the audit endpoints, ensure your API key has the appropriate permissions. The endpoints respect your existing project and account access controls, ensuring you only see audit data within your security scope.

API Documentation

Complete API documentation with detailed request/response schemas is available at developer.tsw.io.

Our developer portal provides:

  • Detailed schema definitions for all request and response objects
  • Authentication and authorization guides

We're committed to providing the tools you need for comprehensive security and compliance monitoring. These new audit endpoints represent another step in giving you complete visibility and control over your Teraswitch infrastructure.

For questions or support, please contact our support team at [email protected].