---
title: "Create or Update Export Configuration"
method: POST
path: "/public/v1/enterprise-export/scores/config"
tags: ["Scores - Enterprise Export"]
---

# Create or Update Export Configuration

`POST /public/v1/enterprise-export/scores/config`

## Request

- Base URL: `https://api.prewave.com`
- URL: `https://api.prewave.com/public/v1/enterprise-export/scores/config`
- Auth: API key in header `X-Auth-Token`
- TypeScript: <https://skmtc.dev/prewave/apis/public-prewave-api/docs/public/v1/enterprise-export/scores/config/post.ts> (a function with typed inputs; its response is checked against the schema)

Create or replace the authenticated user's enterprise export configuration.

Each user has one configuration. A later call replaces it entirely. `runInterval` defaults to `WEEKLY`
when omitted. `enabled`, `collectionIds`, `targetIds`, `perspectiveIds`, and `includeComponents` are required.
`collectionIds` and `targetIds` may be empty arrays. An empty `perspectiveIds` list is accepted and saved,
but the job then produces no scores.

Access to collections, targets, and perspectives is checked when the job runs, not when this request is saved.
Use `GET /public/v1/enterprise-export/scores` and `GET /public/v1/enterprise-export/scores/errors` after a
successful execution.

**Required permission:** `access_enterprise_export_api`

## Request body

- PublicScoreExecutionConfig
  - `runInterval` 'SIX_HOURS' | 'TWELVE_HOURS' | 'DAILY' | 'WEEKLY', required: Defines the time interval for running the export job. Options include SIX_HOURS, TWELVE_HOURS, DAILY, and WEEKLY. Defaults to WEEKLY if not specified.
  - `enabled` boolean, required: Indicates whether the export job is enabled. If false, the job will not run.
  - `collectionIds` integer[], required: List of Prewave Collection IDs to include in the export job.
  - `targetIds` integer[], required: List of Target IDs to include in the export job.
  - `perspectiveIds` integer[], required: List of Perspective IDs to include in the export job.
  - `includeComponents` boolean, required: Indicates whether to include score components and subcomponents in the export result. If true, components will be included.

## Response `200`

Configuration saved. The response body is empty. Read it back with GET scores/config.

## Other responses

- `400`: The request body is missing required fields or has an invalid run interval.
- `403`: 403 Forbidden - Authentication or authorization failure. This status code is returned when: (1) the request lacks valid authentication credentials (missing or invalid X-Auth-Token header), or (2) the authenticated user does not have the required permission to access this resource.
- `404`: A collection, target, or perspective in the configuration was not found or is not accessible.
- `429`: 429 Too Many Requests - API rate limit exceeded. The request has been rejected because the rate limit for this endpoint has been exceeded. Default rate limits: GET requests - 100 per 10 seconds, 500 per minute; POST/PUT/PATCH/DELETE requests - 20 per 10 seconds, 100 per minute. For increased access, please contact customer success.
- `500`: 500 Internal Server Error - An unexpected error occurred on the server. The request may or may not have been processed.

## Changes

- **2026-11-09** `462a5e63fc9f`: 1 breaking
  - removed the media type `application/json` for the response with the status `200`

[Operation history](https://skmtc.dev/prewave/apis/public-prewave-api/changes/public/v1/enterprise-export/scores/config/post.md)

---

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