Skip to main content
GET
/
secrets
/
{name}
/
audit
List proxy egress events that used this credential
curl --request GET \
  --url https://api.superserve.ai/secrets/{name}/audit \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": 123,
    "ts": "2023-11-07T05:31:56Z",
    "sandbox_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "method": "<string>",
    "host": "<string>",
    "path": "<string>",
    "status": 123,
    "sandbox_name": "<string>",
    "secret_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "upstream_status": 123,
    "latency_ms": 123,
    "error_code": "<string>"
  }
]

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
name
string
required

Secret name as set at creation.

Query Parameters

​
limit
integer
default:50
Required range: 1 <= x <= 200
​
before
integer<int64>

Return events with id strictly less than this cursor.

​
status
enum<string>

Narrow by HTTP status class; errors includes 4xx and 5xx.

Available options:
2xx,
3xx,
4xx,
5xx,
errors

Response

Audit events (most recent first)

​
id
integer<int64>
required

Monotonic event id — also the pagination cursor.

​
ts
string<date-time>
required
​
sandbox_id
string<uuid>
required
​
method
string
required
​
host
string
required

Upstream host targeted by the request.

​
path
string
required
​
status
integer<int32>
required

Status the proxy returned to the sandbox.

​
sandbox_name
string | null

Originating sandbox's name at query time. Only populated by cross-sandbox views such as GET /secrets/{name}/audit. Null when the sandbox has since been deleted.

​
secret_id
string<uuid>

Secret involved in this request, if any.

​
upstream_status
integer<int32> | null

Status returned by the upstream (absent if the proxy short-circuited).

​
latency_ms
integer<int32> | null
​
error_code
string | null

Stable error tag when the proxy denied or failed the request.