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
- Type: stringFormat: uuididrequired
GPU VM UUID
Query Parameters
- Type: integerpagemin:1
Page number (1-indexed)
- Type: integerlimitmin:1max:200
Items per page
- Type: stringoccurred
After Lower bound on
occurredAt, inclusive. ISO-8601 timestamp or date-only (2026-03-01). - Type: stringoccurred
Before Upper bound on
occurredAt, inclusive. A date-only value is promoted to the end of that day, so2026-03-15includes events recorded during 2026-03-15.
Responses
- application/json
- 401
Authentication required
- 403
Insufficient permissions (requires audit-log:read)
- 404
GPU VM not found or not accessible in your tenant
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
}
}.png)