Riferimento API / Audit
Audit
Gli endpoint del gruppo Audit dell'API Voiceland AI, con parametri, schemi ed esempi curl.
Ultimo aggiornamento:
Le descrizioni degli endpoint e dei campi restano in inglese, esattamente come le pubblica l'API. È una scelta voluta: qui legge ciò che vedrà anche nelle risposte.
GET /v1/audit#
List audit events. Your tenant-scoped audit trail, newest first.
Parametri
| Nome | Posizione | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|---|
from |
query |
string | Window start (RFC3339). | |
to |
query |
string | Window end (RFC3339). | |
limit |
query |
integer | Max rows. | |
cursor |
query |
string | Pagination cursor. |
Risposte
| Codice | Descrizione |
|---|---|
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. |
Esempio di richiesta
curl "https://api.voiceland.ai/v1/audit" \
-H "Authorization: Bearer VL_API_KEY"Esempio di risposta
{
"items": []
}GET /v1/audit/{id}#
Get an audit event. Returns one audit event by id.
Parametri
| Nome | Posizione | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|---|
id |
path |
string | Sì | Audit event id. |
Risposte
| Codice | Descrizione |
|---|---|
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. |
Esempio di richiesta
curl "https://api.voiceland.ai/v1/audit/{id}" \
-H "Authorization: Bearer VL_API_KEY"Schemi#
Error#
Error envelope returned for non-2xx responses.
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
error |
object | Sì |