API reference / Audit
Audit
The Audit endpoints of the Voiceland AI API, with parameters, schemas and curl examples.
Last updated:
GET /v1/audit#
List audit events. Your tenant-scoped audit trail, newest first.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
from |
query |
string | Window start (RFC3339). | |
to |
query |
string | Window end (RFC3339). | |
limit |
query |
integer | Max rows. | |
cursor |
query |
string | Pagination cursor. |
Responses
| Code | Description |
|---|---|
200 |
Success. |
401 |
Missing or invalid API key. |
402 |
Your plan does not include audit log export (feature_not_entitled), or the account has no subscription (no_subscription). |
4XX |
Request error (validation, not-found, etc.). |
5XX |
Server or upstream error. |
Example request
curl "https://api.voiceland.ai/v1/audit" \
-H "Authorization: Bearer VL_API_KEY"Example response
{
"items": []
}GET /v1/audit/{id}#
Get an audit event. Returns one audit event by id.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path |
string | Yes | Audit event id. |
Responses
| Code | Description |
|---|---|
200 |
Success. |
401 |
Missing or invalid API key. |
402 |
Your plan does not include audit log export (feature_not_entitled), or the account has no subscription (no_subscription). |
4XX |
Request error (validation, not-found, etc.). |
5XX |
Server or upstream error. |
Example request
curl "https://api.voiceland.ai/v1/audit/{id}" \
-H "Authorization: Bearer VL_API_KEY"Schemas#
Error#
Error envelope returned for non-2xx responses.
| Field | Type | Required | Description |
|---|---|---|---|
error |
object | Yes |