---
title: "topic"
method: PUT
path: "/v1/event/{topic}"
tags: ["events"]
---

# topic

`PUT /v1/event/{topic}`

### Creates or updates a given topic

Parameters are specified in the body of the post, as stringified JSON.
No body passed causes a default creation.

## Request body

- TopicCreateOptions — topicCreateOptions documents the request body for creating a topic
  - `configEntries` object
  - `numPartitions` integer
  - `replicationFactor` integer

## Response `201`

## Other responses

- `204`
- `500` — A message describing the error

## Changes

> 50 revisions in range; 1 could not be searched.

- **2020-10-23** `eb809bca1a65` — 1 breaking, 1 warning, 1 info
  - removed the success response with the status `200`
  - the optional response header `body` removed for the status `201`
  - added the success response with the status `204`
- **2020-10-01** `ff182fd1e057` — 1 info
  - added the success response with the status `200`
- **2020-09-10** `7cf975dde9ee` — 1 info
  - endpoint added
- **2020-05-01** `d9f9d9f05f2d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ibm/apis/kar/changes/v1/event/:topic/put.md)

---

[API](https://skmtc.dev/ibm/apis/kar.md) · [All operations](https://skmtc.dev/ibm/apis/kar/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibm/kar/revisions/f288d7bc7700/schema)