---
title: "Refresh experiment results for org"
method: POST
path: "/api/v2/experiments/results/refresh"
tags: ["Experiments"]
---

# Refresh experiment results for org

`POST /api/v2/experiments/results/refresh`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/experiments/results/refresh`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `product_analytics_experiments_write`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/experiments/results/refresh/post.ts> (a function with typed inputs; its response is checked against the schema)

Trigger a results refresh across the organization's active experiments. Returns the count of experiments whose refresh was triggered (meta.experiments_updated) plus a per-experiment breakdown of what happened to each (meta.results).

## Query parameters

- `full_refresh` boolean: Force a full warehouse rebuild. Defaults to false when omitted.

## Response `202`

Accepted

- ExperimentsRefreshExperimentResultsV2DTOArray: List of experiment refresh result resources.
  - `data` ExperimentsRefreshExperimentResultsV2DTOData[], required: Resources returned in this response.
    - `attributes` ExperimentsRefreshExperimentResultsV2DTODataAttributes: Details of the experiment refresh result.
      - `success` boolean: Whether the refresh request succeeded.
    - `id` string, uuid, required: ID of the experiment whose results were refreshed.
    - `type` 'experiment-results-refresh', required: Experiment results refresh resource type.
  - `meta` ExperimentsRefreshExperimentResultsBatchMetaV2DTO: Summary of refresh outcomes across the organization's experiments.
    - `experiments_updated` integer: Number of experiments updated by the refresh request.
    - `results` ExperimentsRefreshExperimentResultsBatchMetaV2DTOResultsItems[]: Refresh outcome reported for each experiment.
      - `experiment_id` string: ID of the experiment associated with this result.
      - `outcome` 'TRIGGERED' | 'SKIPPED_ALREADY_RUNNING' | 'SKIPPED_NOT_EDITABLE' | 'SKIPPED_ORG_AT_CAPACITY' | 'FAILED': Outcome of attempting to refresh one experiment.

## Other responses

- `400`: The full_refresh query parameter is not a valid boolean.
- `401`: Missing or invalid authentication.
- `403`: Authenticated caller lacks the product_analytics_experiments_write permission.
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/3f70db624329?raw)