---
title: "POST /v1/orchestrator/audit_scopes"
method: POST
path: "/v1/orchestrator/audit_scopes"
tags: ["Orchestrator"]
---

# POST /v1/orchestrator/audit_scopes

`POST /v1/orchestrator/audit_scopes`

Creates a new Audit Scope

## Request body

- AuditScope — A Audit Scope binds a target of evaluation to a catalog, so the target of evaluation is evaluated regarding this catalog's controls
  - `id` string, required — Audit Scope ID
  - `name` string, required
  - `targetOfEvaluationId` string, required
  - `catalogId` string, required
  - `assuranceLevel` string — an assurance level is not offered by every catalog, therefore it is optional

## Response `200`

OK

- AuditScope — A Audit Scope binds a target of evaluation to a catalog, so the target of evaluation is evaluated regarding this catalog's controls
  - `id` string, required — Audit Scope ID
  - `name` string, required
  - `targetOfEvaluationId` string, required
  - `catalogId` string, required
  - `assuranceLevel` string — an assurance level is not offered by every catalog, therefore it is optional

## Other responses

- `default` — Default error response

## Changes

- **2025-06-04** `081e87edb928` — 1 breaking, 1 info
  - added the new required request property `name`
  - added the required property `name` to the response with the `200` status
- **2025-03-27** `f2db05790701` — 2 breaking, 1 warning, 1 info
  - added the new required request property `targetOfEvaluationId`
  - removed the required property `certificationTargetId` from the response with the `200` status
  - removed the request property `certificationTargetId`
  - added the required property `targetOfEvaluationId` to the response with the `200` status
- **2024-12-18** `deb7cc4c4785` — 1 breaking, 1 info
  - added the new required request property `id`
  - added the required property `id` to the response with the `200` status
- **2024-10-09** `07cad9c3688b` — 1 info
  - endpoint added
- **2022-11-07** `9aea46cc4c8a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/clouditor/apis/orchestrator-api/changes/v1/orchestrator/audit_scopes/post.md)

---

[API](https://skmtc.dev/clouditor/apis/orchestrator-api.md) · [All operations](https://skmtc.dev/clouditor/apis/orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clouditor/orchestrator-api/revisions/6f8ae69f4eb5/schema)