---
title: "Refresh Audience"
method: POST
path: "/audience/refresh/{audience_id}"
tags: ["audience"]
---

# Refresh Audience

`POST /audience/refresh/{audience_id}`

## Request

- Base URL: `https://api.akkio.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.akkio.com/audience/refresh/{audience_id}`
- Auth: none declared

Refresh an audience and its stats from the stored SQL so that it matches the current data

## Path parameters

- `audience_id` string, required

## Request body

- AudienceRefreshPayload
  - `targets` RefreshTargetEnum[]: List of entities to refresh: 'audience', 'overview', 'insights', 'lookalike'. This list can not be empty
  - `insight_context_list` InsightContext[], nullable: Limit insight refresh to specific insights. This parameter is ignored if insights are not being refresed in this call.

## Response `200`

Successful Response

- AsyncJobRecord: Do NOT access this table directly.
  - `id` integer, nullable: ID of this object.
  - `created_at` string, date-time, nullable: datetime object representing when this object was created.
  - `updated_at` string, date-time, nullable: datetime object representing when this object was updated.
  - `deleted_at` string, date-time, nullable: datetime object representing when this object was deleted.
  - `status` 'RUNNING' | 'COMPLETED' | 'FAILED'
  - `endpoint` string: Endpoint spawning async job
  - `request` union: request sent to endpoint
    - object
    - unknown[]
      - unknown
  - `sync_response` union: sync response
    - object
    - unknown[]
      - unknown
  - `error` string, nullable: error message
  - `response` unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/akkio/apis/akkio-api.md) - [All operations](https://skmtc.dev/akkio/apis/akkio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akkio/apis/akkio-api/revisions/c477deff6271?raw)