---
title: "Starts a new audience state recalculation for the given audience."
method: POST
path: "/audience/{audienceId}/state-recalculation"
tags: ["Audience"]
---

# Starts a new audience state recalculation for the given audience.

`POST /audience/{audienceId}/state-recalculation`

If a recalculation is already Pending for this audience, its id is returned and no new
 run is created. If one is currently Processing, it is aborted and replaced. Failed,
 Completed, and Aborted runs are left untouched and a fresh run is created.

## Path parameters

- `audienceId` string, required

## Response `200`

OK

- StartAudienceStateRecalculationEndpointOutput
  - `recalculationId` string, required — The id of the recalculation that was started or reused.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.net/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.net/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/versions/e42ec51c7b88/schema)