API: Removing tags
Available since FileRun 2026.3.0.
| Target URL | /api.php/Drive/files/tags/remove |
| Required scope | metadata |
| HTTP Method | POST |
| Output format | JSON |
Request Parameters Reference
| Parameter | Type | Required | Description |
|---|---|---|---|
| path | string | Yes | See this page |
| ids | array | Yes | Array of tag record ids, as returned by Listing tags. |
Requires the account permission to access metadata and, since FileRun 2026.4.0, the permission to change metadata (write_metadata). Before, it required the permission to make changes.
The response
The request is successful as a whole. The results object holds one entry per submitted id, keyed by the id:
| Field | Type | Description |
|---|---|---|
| success | boolean | true if the tag was removed, false if not. |
| msg | string | The textual description of the result of the action. |
A tag id which is not attached to the item named by path (a tag of another item, or an id which no longer exists) is refused in its own entry, with the message The tag with the id "123" is not attached to "file.txt"!. The other ids of the same request are still processed.