---
title: "PUT /public/self-serve/v1/topic-policy"
method: PUT
path: "/public/self-serve/v1/topic-policy"
tags: ["cli_topic-policy_self-serve_v1_5"]
---

# PUT /public/self-serve/v1/topic-policy

`PUT /public/self-serve/v1/topic-policy`

## Request

- Base URL: `https://developers.conduktor.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developers.conduktor.io/public/self-serve/v1/topic-policy`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/conduktor/apis/conduktor-console-api/docs/public/self-serve/v1/topic-policy/put.ts> (a function with typed inputs; its response is checked against the schema)

Create or update a TopicPolicy

**Requires a paid license.** Returns 403 Forbidden on Free plan.

## Query parameters

- `dryMode` boolean

## Request body

- TopicPolicyResourceV1
  - `apiVersion` string, required
  - `kind` 'TopicPolicy', required
  - `metadata` ApplicationPolicyMetadata, required
    - `name` string, required
  - `spec` ApplicationPolicySpec, required
    - `policies` MapPolicyConstraintDto, required

## Response `200`

- TopicPolicyApplyResultV1
  - `resource` TopicPolicyResourceV1, required
    - `apiVersion` string, required
    - `kind` 'TopicPolicy', required
    - `metadata` ApplicationPolicyMetadata, required
      - `name` string, required
    - `spec` ApplicationPolicySpec, required
      - `policies` MapPolicyConstraintDto, required
  - `upsertResult` 'Created' | 'Updated' | 'NotChanged', required

## Other responses

- `400`: The request is not valid
- `401`: The user is not authenticated
- `403`: The user doesn't have sufficient privilege to do this operation
- `404`: No topic-policy with this technical id exists
- `409`: The request does not match one of the business rules
- `500`: An unexpected error occurred in the server

---

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