PUT/api/orgs/{org_id}/telemetry-settings

Turn prompt and response storage on or off

Turning storage off needs Pro or a grandfathered organization (403 needs_subscription); turning it on is open to every plan but is refused with 409 capture_cleanup_pending while a previous erasure is unfinished. A same-value write is a no-op. Needs an org admin or the organization's own API key.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

Request body

  • capture_prompt_contentbooleanrequired

    False needs Pro or a grandfathered organization.

Responses

  • 200

    The setting after the write.

    Response
    • capture_prompt_contentbooleanrequired

      Whether prompt and response bodies and Responses continuations are stored.

    • cleanupobjectrequired

      Erasure progress for stored content after storage was turned off.

      cleanup
      • statusenumrequired
        "none""pending""failed""completed"
      • requested_atstring | nullrequired
      • completed_atstring | nullrequired
      • deleted_promptsintegerrequired
      • deleted_continuationsintegerrequired
  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 403

    Turning storage off needs Pro (or a grandfathered organization), or the caller is a member below admin.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The resource does not exist or belongs to another organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 409

    Stored content from an earlier opt-out is still being erased.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    Response
    • detailarray<object>required
      detail
      • typestring
      • locarray<string | integer>
      • msgstring

Request

curl -X PUT https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/telemetry-settings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "capture_prompt_content": false
}'

Response

{
  "capture_prompt_content": false,
  "cleanup": {
    "status": "pending",
    "requested_at": "2026-11-19T11:04:12.550Z",
    "completed_at": null,
    "deleted_prompts": 0,
    "deleted_continuations": 0
  }
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/telemetry-settings