---
title: "Change the organisation settings for the Analytics screen"
method: PUT
path: "/analytics/v1/settings"
tags: ["analytics"]
---

# Change the organisation settings for the Analytics screen

`PUT /analytics/v1/settings`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/analytics/v1/settings`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

Organisation owners and admins only — anyone else is refused with 403 by the endpoint permission catalogue. Returns the stored value, and records the caller as the last editor.

## Request body

- UpdateAnalyticsSettingsRequest: Body of PUT /analytics/v1/settings. Admins only; the catalogue enforces it. Unknown fields are refused, not ignored (QSA-1842): the coverage warning threshold is deployment configuration, and a body that tries to set it must get a 422 rather than a 200 that changed nothing.
  - `analytics_team_view` boolean, required

## Response `200`

Successful Response

- AnalyticsSettingsResponse: What the organisation has decided about the Analytics screen.
  - `analytics_team_view` boolean, required: When true, every member of the organisation sees all developer rows on the Analytics screen. When false, a non-admin sees only their own.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)