Telemetry Settings Api Acknowledge Telemetry Disclosure
Record that the disclosure notice was acknowledged. ADMIN only. Informational; gates no upload.
200 OK successful response envelope. The telemetry settings with the disclosure notice recorded as acknowledged
{
"shareAdditionalData": true,
"endpoint": "production",
"proxyUrl": "http://proxy.example.com:3128",
"retentionDays": 180,
"installationId": "00000000-0000-4000-8000-000000000031",
"secretConfigured": true,
"operatorDisabled": false,
"disclosureAcknowledgedAt": "2026-01-15T09:30:00Z"
}
Whether the additional tier is included in reports generated from now on
Upload endpoint selection
production: The Broadcom production endpoint; the default of a release buildstaging: The Broadcom staging endpoint; the default of a build that is not a release buildcustom: An https URL from configuration (vtp.telemetry.custom-url) without user info, query or fragment; refused in a release build
Optional proxy URL without userinfo
SHA-256 fingerprint of the custom CA bundle, when one is set
Days reports are kept, 90 to 365
Stable installation id (UUID)
Whether the product credential was delivered to the appliance
Whether the support-only operator kill switch is set. Read-only.
When an administrator acknowledged the disclosure notice, if ever
401 Unauthorized: UNAUTHENTICATED when the VTP_SESSION cookie is missing, unknown, expired or revoked
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
403 Forbidden error response (including LICENSE_EXPIRED while the license is restricted). CSRF_ERROR when the X-XSRF-TOKEN header is missing or wrong on a POST, PUT, PATCH or DELETE (only POST /api/v1/auth/login is exempt, and a request without a valid session gets 401 UNAUTHENTICATED instead); PASSWORD_CHANGE_REQUIRED when the account must change its password first (only GET /api/v1/auth/session, POST /api/v1/auth/logout and POST /api/v1/auth/change-password are exempt); LICENSE_REQUIRED or LICENSE_EXPIRED while the license pool is restricted (no license, or expired past grace) (exempt: every route under /api/v1/auth, GET /api/v1/user/preferences, GET /api/v1/licensing/summary and POST /api/v1/licensing/licenses)
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
500 Internal Server Error: INTERNAL_ERROR when the server fails unexpectedly; the message carries no detail
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
curl -X POST -H 'Authorization: <value>' https://{api_host}/api/v1/settings/telemetry/disclosure-ack