Viddler

Updated video details.

Note: ALL arguments are required.

Authenication

This method requires authentication with viddler.users.auth API method.

Arguments

method

Should be set to “Viddler.videos.setDetails”

api_key

Assigned Viddler API Key

sessionid

Current session in generated by calling viddler.users.auth method

video_id

The ID of the video which you want to update

title ^(optional)

Video title – 500 characters max

description ^(optional)

Video description

tags ^(optional)

List of tags to be set on video. Setting tags will update current tags set (both timed and global video tags). To set timed tag use formattagname[timestamp_in_ms] as tagname. For example – usingtag1,tag2,tag3[2500] will set 2 global and 1 timed tag at 2.5s

view_perm ^(optional)

View permission. Can be set to public, shared_all, shared or private

view_users ^(optional)

List of users which may view this video if view_perm is set to shared. Only your viddler friends are allowed here. If you provide multiple usernames – non valid viddler friends usernames will be ignored.

view_use_secret ^(optional)

If view_perm is set to non public value, you may activate secreturl for your video. If you want to enable or regenerate secreturl pass “1” as parameter value. If you want to disable secreturl pass “0” as parameter value.

embed_perm ^(optional)

Embedding permission. Supported permission levels are the same as forview_perm. This and all permissions below cannot be less restrictive thanview_perm. You cannot set it to public if view_perm is for example shared.

embed_users ^(optional)

Same as view_users. If view_perm is shared, this list cannot contain more users than view_users. Invalid usernames will be removed.

commenting_perm ^(optional)

Commenting permission. Description is the same as for embed_perm

commenting_users ^(optional)

Same as embed_users.

tagging_perm ^(optional)

Tagging permission. Description is the same as for embed_perm

tagging_users ^(optional)

Same as embed_users.

download_perm ^(optional)

Download permission. Description is the same as for embed_perm

download_users ^(optional)

Same as embed_users.

Notes

• Invalid arguments will be ignored
• All lists are coma or space separated
• Support for buddy lists sharing will be added soon
• Consider using HTTP POST method if this api method call becomes too large.

Example Call

http://www.viddler.com/api_rest?method=viddler.videos.setDetails&apki_key=12345678&sessionid=12345678video_id=12345678&view_perm=public

Example Response

This method will return the same response as viddler.videos.getDetails so you’ll instantly be able to compare sent data to what actually was set.

Error Codes

Standard error codes plus: