SparQDocs
GuidesAPI referencesparqhq.ai
API referenceObservability

List Audit

GET
/v1/admin/audit

Audit records, oldest first. With project_id, that project's records; otherwise the caller's own workspace. cursor continues from the previous page.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Bearer credential. API keys look like sqk_<geo>_<key_id>_<secret>: treat them as opaque and never put one in a browser. Older keys without the geo part stay valid until rotated. Find a geo's endpoints through GET /.well-known/sparq-discovery before sending a key.

Query Parameters

project_id?|null
credential_id?|null
since?|null
until?|null
cursor?|

From the previous page.

Header Parameters

Sparq-Workspace?string

For a person signed in to a console with several workspaces: the workspace this call is for, one of their memberships (listMyMemberships). Without it such a person gets workspace_required (400); a workspace they are not a member of is forbidden. It never grants anything, and other callers' credentials ignore it.

Formatuuid

Response Body

Successful Response

application/json
  1. response
items*array<>
next_cursor*string|null
Example Request
curl -X GET 'http://dev-sparq.centralindia.cloudapp.azure.com:8000/v1/admin/audit'
Example Response
{  "items": [    {      "audit_event_id": "d37b9f39-3c58-44db-9258-50fa017ec413",      "occurred_at": "2019-08-24T14:15:22Z",      "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",      "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",      "audience_tenant_id": "0287c3f7-886a-49f4-a73e-03577e798c26",      "actor": {        "principal_type": "user",        "principal_id": "string",        "credential_id": "13c40afa-2996-4a0c-b2e9-68fba9462242"      },      "action": "release.publish",      "target": {        "type": "string",        "id": "string"      },      "outcome": "allowed",      "reason": "string",      "policy_version": "string",      "request_id": "string",      "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",      "details": {        "property1": "string",        "property2": "string"      },      "previous_hash": "string",      "record_hash": "string",      "correlation_id": "string",      "plane": "string"    }  ],  "next_cursor": "string"}

Get Trace GET

> **Not available yet.** This operation is part of the published contract and answers `501 not_implemented` until it is built. The request and response shapes below are final for this contract version. Span content only where the client's trace content policy allows it.

List Trace Destinations GET

> **Not available yet.** This operation is part of the published contract and answers `501 not_implemented` until it is built. The request and response shapes below are final for this contract version.