---
title: "Update the topic details"
method: PUT
path: "/topics/{id}"
tags: ["Private"]
---

# Update the topic details

`PUT /topics/{id}`

Updates a topic's details for the next nested object.

## Path parameters

- `id` string, required

## Request body

- TopicUpdate — Object containing topic data update.
  - `title` string, required — The title of a topic.
  - `slug` string, required — The slug of a topic.
  - `description` string, required — The description of a topic.
  - `release_date` string, date-time, required — The release date formatted to abide by RFC3339.
  - `keywords` string[] — List of keywords that relate to the topic.
  - `state` 'created' | 'published' | 'completed', required — The state of the resource.
  - `subtopics_ids` string[] — Array of subtopic ids

## Response `200`

Success

## Other responses

- `400` — The request was invalid.
- `401` — Failed to process the request due to being unauthorised.
- `404` — The specified resource was not found.
- `500` — Failed to process the request due to an internal error.

---

[API](https://skmtc.net/office-of-national-statistics/apis/topic-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/topic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/topic-api/versions/84b8391c5030/schema)