---
title: "Setting new configuration for Usage Reporting"
method: POST
path: "/v1/config/analytics"
tags: ["System Configuration"]
---

# Setting new configuration for Usage Reporting

`POST /v1/config/analytics`

An Administrator can use this endpoint to choose whether the server will share anonymous usage data with the Central team. This configuration affects the entire server. Until the Usage Reporting configuration is set, Administrators will see a message on the Central administration website that provides further information.

If an Administrator specifies `true` for `enabled`, the server will share anonymous usage data monthly with the Central team. By specifying `true`, the Administrator accepts the [Terms of Service](https://getodk.org/legal/tos) and [Privacy Policy](https://getodk.org/legal/privacy). The Administrator can also share contact information to include with the report.

If an Administrator specifies `false` for `enabled`, the server will not share anonymous usage data with the Central team. Administrators will no longer see the message on the administration website.

If the Usage Reporting configuration is already set, the current configuration will be overwritten with the new one.

## Response `200`

OK

- ConfigAnalytics
  - `key` string, required — The type of system configuration.
  - `setAt` string, required — ISO date format. The last time this system configuration was set.
  - `value` ConfigAnalyticsValue, required
    - `enabled` boolean, required — `true` if the server will share usage data with the Central team and `false` if not.
    - `email` string — The work email address to include with the metrics report.
    - `organization` string — The organization name to include with the metrics report.

## Changes

- **2026-04-03** `2aed27d9e013` — 4 breaking, 3 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `key` from the response with the `200` status
  - removed the required property `setAt` from the response with the `200` status
  - removed the required property `value` from the response with the `200` status
  - …3 more
- **2025-12-20** `022694254f0d` — 1 info
  - api operation id `Setting a new configuration` removed and replaced with `setConfiguration`
- **2025-10-27** `b11b54eea487` — 1 info
  - removed the non-success response with the status `403`
- **2025-03-13** `e8c2858fd4eb` — 1 breaking, 8 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - api operation id `setConfiguration` removed and replaced with `Setting a new configuration`
  - api tag `Usage Reporting Configuration` added
  - api tag `System Configuration` removed
  - …5 more

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/config/analytics/post.md)

---

[API](https://skmtc.dev/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.dev/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getodk/odk-central-api/revisions/d4f5ba77f644/schema)