Skip to Content

TwentyThree™ API

API Method: /api/photo/get-update-token

Pre-authenticate a meta data update of either a video or a photo.

This method can be used to pre-authenticated client changes without proxying them through your servers and the API. The flow is very similar to the one described in detail in the Browser-based uploads section of the API documentation, but in general terms this method will return a token which can be included in an update request from a standard HTML form or HTTP request.


photo_idThe photo object to be updated.
valid_minutesHow many minutes should the token be valid for. The default is 180 minutes (or 3 hours). The minimum value is 15 minutes and the maximum is 24 hours.
max_usesHow many times may the returned token be uses? The default is 1 upload; the maximum is 100

Permission level

The minimum required permission level is:


Example XML Response

<response status="ok" permission_level="write" 
  message="The update token is ready to use" cached="0">

Example JSON Response

  "status": "ok", 
  "message":"The update token is ready to use",
    "valid_minutes": "180", 
    "update_token": "022fe6e3fb42758d6147c539727c5358af3524b1", 
    "max_uses: "1", 
    "valid_until": "1266713254", 
    "photo_id": "123456"
  "p": "1",
  "size": "1",
  "site": { ... },
  "endpoint": "/api/photo/get-update-token"