Overview
public. Sets the tags on a page.
Uri Parameters
| Name | Type | Description |
| pageid | string | either an integer page ID, "home", or "=" followed by a double uri-encoded page title |
Query Parameters
| Name | Type | Description |
| authenticate | bool? | Force authentication for request (default: false) |
| redirects | int? | If zero, do not follow page redirects. |
Return Codes
| Name | Value | Description |
| BadRequest | 400 | Invalid input parameter or request body |
| Forbidden | 403 | Update access to the page is required |
| NotFound | 404 | The requested page could not be found |
| Ok | 200 | The request completed successfully |
Message Format
Input:
<tags>
<tag value="{text}" />
...
</tags>
Output:
<tags count="{int}" href="{uri}">
<tag value="{text}">
<type>{text|date|define}</type>
<uri>{text}</uri>
<title>{text}</title>
<related count="{int}">
<page id="{int}" href="{uri}">
<title>{text}</title>
<path>{text}</path>
</page>
</related>
</tag>
...
</tags>
Implementation Notes
Tagging is a means of categorizing pages. There are currently three types of supported tags:
- Date: Defines a date or date range for the page.
- Define: Indicates that this is a defining tag. All other pages with a text tag having the same name will be marked as related to the page.
- Text: Standard tag type.
NOTE: When you do it this way, it will OVERWRITE all other tags on your page. You may want to do a GET first to get all your tags and append them to my.xml
curl -b cookies.txt -d @my.xml -X PUT -H "Content-type: text/xml" "http://myserver/@api/deki/pages/{xxx}/tags/?"
my.xml contains the following text:
<tags><tag value="MY TAG" /></tags> edited 23:57, 21 Feb 2008