POST/api/v1/user/telemetry-preferences

Set telemetry preferences (environment-controlled)

Endpoint acknowledges request but reports environment-controlled behavior rather than persisting user preference.

Response body

Success response 200 · schema MetaUtilityApiSuccessV1

dataanyOf

anyOf (option 1)object

anyOf (option 2)array of object

itemsobject

anyOf (option 3)string

anyOf (option 4)number

anyOf (option 5)boolean

anyOf (option 6)null

flagsobject

contextobject

enabledboolean

reasonstring

usageStatsEnabledboolean

controlledBystring

messagestring

successboolean

Response codes

200

Operation succeeded.

400

Invalid request payload/query.

401

Unauthorized (API key/session auth failure depending on route).

403

Permission denied.

500

Unexpected route/controller failure.

POST /api/v1/user/telemetry-preferences

cURL

curl -X POST "https://algapsa.com/api/v1/user/telemetry-preferences" \
  -H "X-API-Key: $ALGA_API_KEY"

TypeScript

const response = await fetch("https://algapsa.com/api/v1/user/telemetry-preferences", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/v1/user/telemetry-preferences");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "data": {},
  "flags": {},
  "context": {},
  "enabled": false,
  "reason": "string",
  "usageStatsEnabled": false,
  "controlledBy": "string",
  "message": "string",
  "success": false
}