API Method: /api/photo/update-upload-token
Update the meta data of a photo or video, which has previously been or is in the process of being uploaded to the site through browser-based uploading.
Parameters
Parameter | Description |
---|---|
upload_token (required) | The upload token being used. |
album_id | A album (or channel) ID. |
title | A title for the upload. All HTML tags will be stripped away from the title. |
description | A description of upload. The value can include save HTML tags such as <b> or <p>; however, if any disallowed tags are included, all html with be stripped from the description. |
tags | Space-separated list of tags to attach to the uploaded file. |
publish | Should the file be published in the site immediately? Default is 1. Valid values: 0 or 1 |
Parameters for Resumable.js
This API methods support an extra set of parameters designed to work with Resumable.js, an open sourced JavaScript library for providing multiple simultaneous, stable, fault-tolerant and resumable uploads via the HTML5 File API released by TwentyThree.
You can update the meta data for a specific file being uploaded through Resumable.js by including the file's resumableIdentifier
in the update request along with the parameters listed above.
Permission level
The minimum required permission level is:
none
For non-public sites, the minimum level is:
anonymous
Example XML Response
<response status="ok" permission_level="write"
message="The token information was updated" cached="0"/>
Example JSON Response
{
"status": "ok",
"message":"The token information was updated",
"permission_level":"write",
"cached":"0",
"photo":{},
"p": "1",
"size": "1",
"site": { ... },
"endpoint": "/api/photo/update-upload-token"
}