---
name: docs/confluence-official:label-remove
description: Remove a label from a Confluence page
version: "0.5.0"
---

> **Backend:** confluence-official (atlassian@claude-plugins-official)
> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`
> **Plugin Support:** This operation may not be directly supported by the official Atlassian plugin. If unavailable, use CQL search as a workaround or switch to a custom backend with `DOC_BACKEND_OVERRIDE: confluence-custom`.

# Label Remove

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| page_id | string | Yes | Confluence page ID |
| label | string | Yes | Label string to remove |

## Implementation

No direct tool equivalent exists in `atlassian@claude-plugins-official`. If label management is required, switch to the custom backend:

```
DOC_BACKEND_OVERRIDE: confluence-custom
```

If the plugin gains a dedicated label tool in a future release, it will appear as `mcp__atlassian__removeConfluencePageLabel`.

## Output

| Field | Type | Description |
|-------|------|-------------|
| success | boolean | Whether the label was removed successfully |
| remaining_labels | string[] | Labels still applied to the page after removal |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| NOT_FOUND | Page ID does not exist | Verify page_id with `confluence-official:page-read` |
| LABEL_NOT_PRESENT | Label is not applied to this page | No action needed; label is already absent |
| PERMISSION_DENIED | Token lacks write access to the page | Check plugin configuration and Confluence token scopes |
| PLUGIN_UNAVAILABLE | atlassian@claude-plugins-official plugin is not installed or not responding | Run `/plugin install atlassian@claude-plugins-official` and retry |

## Used By

- sync-context (removing stale classification labels during sync)
