API: Add tags
| Target URL | /api.php/Drive/files/tags/add |
| Required scope | metadata |
| HTTP Method | POST |
| Output format | JSON |
Request Parameters Reference
| Parameter | Type | Required | Description |
|---|---|---|---|
| path | string | Yes | See this page |
| tags | array | Yes | Array of strings. Tags to be added. (Keys are discarded.) |
The tag format
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
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.