| Target URL | /api.php/Drive/files/tags/add |
| Required scope | metadata |
| HTTP Method | POST |
| Output format | JSON |
| Parameter | Type | Required | Description |
|---|---|---|---|
| path | string | Yes | See this page |
| tags | array | Yes | Array of strings. Tags to be added. (Keys are discarded.) |
Example tag: important|red, where important is the tag's text,
red is the color.
This color should be a valid HTML color, a hex value or named color.
The color is optional, so the tag can be just the text part (important).
The response contains the results array with the following information:
| Field | Type | Description |
|---|---|---|
| success | boolean | true if the value was set, false if not. |
| tag | array | The parsed tag, split in text and color. |
| msg | string | The textual description of the result of the action. |
The key of each result item is the specified tag itself.