TwentyThree Developer APIAPI Method: /api/photo/redeem-replace-token

API Method: /api/photo/redeem-replace-token

Last updated on September 9, 2013.

This method performs the same action as /api/photo/replace, but authenticates the request through the token retrieved from /api/photo/get-replace-token. This means that you can pre-authenticate a replacement upload of either a video, a thumbnail for a video or a photo -- and then allows the client to upload directly to 23's servers from a web browser.

See the documentation on browser-based uploads for more information.

Any extra parameters sent to this method will be repeated in the callback request to return_url.

Parameters

ParameterDescription
file (required)The file to upload.
replace_token (required)The token returned by a call to /api/photo/get-replace-token

Permission level

The minimum required permission level is:

anonymous

Returns

A plain, unstyled error message if the replace_token is invalid, consumed or expired. Otherwise the client is redirected to return_url using the method specified in the flow description.

If background_return_p was set to 1 when retrieving the upload token, the callback to return_url is made from the server-side and one of the following information sets is returned:

ok <domain> <tree_id> <photo_id> <token> <callback_url>

Or:

error <error_message>