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

# Setting a new configuration

`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

- object
  - `key` string, required — The type of system configuration.
  - `setAt` string, required — ISO date format. The last time this system configuration was set.
  - `value` object, required — Details about the Usage Reporting configuration.
    - `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.

## Other responses

- `403` — Forbidden

## Changes

- **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/fc2f2c8bd6a4/schema)