Open topic with navigation

Set Media Title

Set the title (up to 128 characters) for a media item.

User Login Required

Yes. See End-User Authentication for details.

HTTP Method

POST or PUT

REST Path

/media/[identifier]/title

See Object Identifiers for an [identifier] explanation.

Parameters

Request Example

The request updates the title for the image "ferrari.jpg".

PUT http://api123.photobucket.com/media/http%3A%2F%2Fi123.photobucket.com%2Falbums%2Fgg17%2Fpbapi%2Fferrari.jpg/title?format=xml&oauth_consumer_key=00000000&oauth_nonce=cc25d363e5f72fd31c2dcf2498746a35&oauth_signature=X%2FXdrpmz73gheBXzE%2F%2Bm8Aeay50%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1205278888&oauth_token=28.1&oauth_version=1.0&title=ferrariTitle

Response Example

A successful response looks similar to:

<response>

    <status>OK</status>

    <content>

        <media>1</media>

    </content>

    <format>xml</format>

    <method>PUT</method>

    <timestamp>1202845954</timestamp>

</response>

Error Codes

The following errors may be returned: 

• 009: Insufficient permissions
• 126: Title to long
• 141: Media specified was not found
• 152: The title parameter is required

For a full list of possible errors, see Error Codes.

Open topic with navigation