TwentyThree Developer APIAPI Method: /api/photo/update

API Method: /api/photo/update

Last updated on September 9, 2013.

Update the meta data -- including title, description, tags, channel/album and publish status -- of a photo or video.

The only required parameter is photo_id. Whenever parameters are omitted, the current value is retained.

Parameters

ParameterDescription
photo_id (required) ID of the photo or video.
album_id An album (or channel) ID. Multiple values should be comma-separated.
title The title for the photo or video.
description A description for the object. 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 object. If this parameter is omitted, existing tags are left unchanged. If the paramter is specified, all existing tags will be overwritten with the new value.
published_p Is the video published?
Allowed values: 0 or 1

Permission level

The minimum required permission level is:

write

Example XML Response

<response status="ok" permission_level="write" 
  message="The photo/video was updated" cached="0"/>

Example JSON Response

{
  "status": "ok", 
  "message":"The photo/video was updated",
  "permission_level":"write",
  "cached":"0",
  "photo":{},
  "p": "1",
  "size": "1",
  "site": { ... },
  "endpoint": "/api/photo/update"
}