- Method:
GET
- Path:
/v1/orgs/{org}/audit-log
- Operation ID:
readAuditLog
- Tag: Audit log
Send Authorization: Bearer <credential>. The credential is either an API key (vsk_…) created for an organization, or an OIDC access token obtained by signing in to VirtScale.
| Name |
Type |
Required |
Description |
org |
string (uuid) |
Yes |
The organization’s id. |
| Name |
Type |
Required |
Description |
action |
string, nullable |
No |
Exact action, e.g. bucket.create |
resource_type |
string, nullable |
No |
bucket, api_token, … |
actor |
string, nullable |
No |
Exact actor subject |
result |
string, nullable |
No |
accepted | denied | invalid |
since |
string (date-time), nullable |
No |
Inclusive lower bound on ts |
until |
string (date-time), nullable |
No |
Exclusive upper bound on ts |
cursor |
string, nullable |
No |
Opaque cursor from next_cursor |
limit |
integer |
No |
|
| Field |
Type |
Required |
Enum |
Description |
items |
array of AuditEventOut |
Yes |
|
|
items.action |
string |
Yes |
|
|
items.actor_realm |
string |
Yes |
|
|
items.actor_sub |
string |
Yes |
|
|
items.actor_token_id |
string (uuid), nullable |
No |
|
|
items.after |
object, nullable |
No |
|
|
items.before |
object, nullable |
No |
|
|
items.id |
string (uuid) |
Yes |
|
|
items.operation_id |
string (uuid), nullable |
No |
|
|
items.reason |
string, nullable |
No |
|
|
items.request_id |
string, nullable |
No |
|
|
items.resource_id |
string, nullable |
No |
|
|
items.resource_type |
string |
Yes |
|
|
items.result |
string |
Yes |
|
|
items.ts |
string (date-time) |
Yes |
|
|
next_cursor |
string, nullable |
No |
|
|
Every error response is application/problem+json (schema Problem).
| Status |
Meaning |
| 400 |
The request is malformed or failed validation. |
| 401 |
The credential is missing or invalid. |
| 404 |
The resource does not exist. |
| default |
Any other status is possible; the code field identifies the error. |
curl "https://api.virtscale.nl/v1/orgs/$ORG_ID/audit-log" \
-H "Authorization: Bearer $VIRTSCALE_API_KEY"