Skip to Content

TwentyThree™ API

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

ParameterDescription
upload_token (required)The upload token being used.
album_idA album (or channel) ID.
titleA title for the upload. All HTML tags will be stripped away from the title.
descriptionA 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.
tagsSpace-separated list of tags to attach to the uploaded file.
publishShould 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"
}