---
title: "Add labels to content"
method: POST
path: "/wiki/rest/api/content/{id}/label"
tags: ["Content labels"]
---

# Add labels to content

`POST /wiki/rest/api/content/{id}/label`

Adds labels to a piece of content. Does not modify the existing labels.

Notes:

- Labels can also be added when creating content ([Create content](#api-content-post)).
- Labels can be updated when updating content ([Update content](#api-content-id-put)).
This will delete the existing labels and replace them with the labels in
the request.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to update the content.

## Path parameters

- `id` string, required

## Request body

- union
  - LabelCreate[]
    - `prefix` string, required — The prefix for the label. `global`, `my` `team`, etc.
    - `name` string, required — The name of the label, which will be shown in the UI.
  - LabelCreate
    - `prefix` string, required — The prefix for the label. `global`, `my` `team`, etc.
    - `name` string, required — The name of the label, which will be shown in the UI.

## Response `200`

Returned if the labels are added to the content.

- LabelArray
  - `results` Label[], required
    - `prefix` string, required
    - `name` string, required
    - `id` string, required
    - `label` string, required
  - `start` integer
  - `limit` integer
  - `size` integer, required
  - `_links` GenericLinks

## Other responses

- `400` — Returned if; - The body contains labels with invalid characters or too many characters. - The body contains too many labels. - The target content would contain too many labels after the operation. - The calling user does not have permission to edit labels.
- `403` — Returned if the calling user can view but not edit the content.
- `404` — Returned if; - There is no content with the given ID. - The calling user does not have permission to view the content.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api/revisions/70088490f406/schema)