List audit events for a GPU VM

​

Returns paginated audit events scoped to a single GPU VM owned by the your tenant. Requires audit-log:read permission. This endpoint does not emit an audit row.

Soft-deleted GPU VMs return 404 from this view; their event history remains reachable via the audit log explorer.

Update-class events carry change evidence in context: before / after (changed keys only), changedFields, and — when applicable — redactedFields (values withheld by policy) and droppedFields (values dropped for size; the diff is partial). Create/delete/read events return no diff. Detail-table state (audit_resource_events) fills in only where the signed metadata supplied nothing.

Path Parameters

  • GPU VM UUID

Query Parameters

  • Page number (1-indexed)

  • Items per page

  • Lower bound on occurredAt, inclusive. ISO-8601 timestamp or date-only (2026-03-01).

  • Upper bound on occurredAt, inclusive. A date-only value is promoted to the end of that day, so 2026-03-15 includes events recorded during 2026-03-15.

Responses

  • application/json
  • Authentication required

  • Insufficient permissions (requires audit-log:read)

  • GPU VM not found or not accessible in your tenant

Request Example for get/resource/gpu/{id}/events
curl https://api.gpcn.com/v1/resource/gpu/123e4567-e89b-12d3-a456-426614174000/events \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'
{
  "success": true,
  "data": [
    {
      "eventId": "123e4567-e89b-12d3-a456-426614174000",
      "timestamp": "2026-10-21T16:19:07.193Z",
      "schemaVersion": 1,
      "actor": {
        "type": "user",
        "userId": "123e4567-e89b-12d3-a456-426614174000",
        "userEmail": "string",
        "name": "string",
        "display": "string",
        "apiKeyId": "string",
        "sessionId": "string",
        "sourceIp": "string",
        "userAgent": "string",
        "parentEntityId": "123e4567-e89b-12d3-a456-426614174000"
      },
      "event": {
        "category": "string",
        "action": "string",
        "result": "success",
        "errorCode": "string",
        "description": "string",
        "descriptionTemplate": "string"
      },
      "target": {
        "entityId": "123e4567-e89b-12d3-a456-426614174000",
        "entityName": "string",
        "resourceType": "string",
        "resourceId": "string",
        "resourceName": "string"
      },
      "context": {
        "requestId": "string",
        "jobId": "123e4567-e89b-12d3-a456-426614174000",
        "onBehalfOfUserId": "123e4567-e89b-12d3-a456-426614174000",
        "flags": {
          "isPrivilegedGrant": true,
          "dataExposureRisk": true
        },
        "parameters": {
          "additionalProperty": "string"
        },
        "before": {
          "additionalProperty": "anything"
        },
        "after": {
          "additionalProperty": "anything"
        },
        "changedFields": [
          "string"
        ],
        "droppedFields": [
          "string"
        ],
        "redactedFields": [
          "string"
        ]
      }
    }
  ],
  "meta": {
    "total": 100,
    "page": 1,
    "pageSize": 20,
    "totalPages": 5,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}