Trace Settings API

All endpoints verified working via curl. Document updated only after curl confirmation.

Base path: /api/v1/traces/settings. Team-scoped, single row per team, lazily created on first write (updatedAt is null until the team has ever written a value — reads before that return the default { capturePayloads: true, updatedAt: null }). GET allows any team member (requireAnyAuth); PUT requires owner or admin (requireRole('owner', 'admin')).

---

GET /api/v1/traces/settings

curl

curl $ACRUXCORE_BASE_URL/traces/settings \
  -H "Authorization: Bearer $ACRUXCORE_API_KEY"

TypeScript

const settings = await hub.traces.getSettings();

Python

settings = await hub.traces.get_settings()

Response (status 200) — before any write, lazy default:

{
  "capturePayloads": true,
  "updatedAt": null
}

---

PUT /api/v1/traces/settings

Requires owner/admin role. Toggles the team's default for whether trace payload bodies (inputs/outputs) get captured on ingest.

curl

curl -X PUT $ACRUXCORE_BASE_URL/traces/settings \
  -H "Authorization: Bearer $ACRUXCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"capturePayloads": true}'

TypeScript

const settings = await hub.traces.updateSettings(true);

Python

settings = await hub.traces.update_settings(True)