API Method: /api/album/create
Create a new album or category.
Parameters
Parameter | Description |
---|---|
title (required) | The album title. All HTML tags will be stripped away from the title. |
description | Description of the album. 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. |
hide_p (deprecated) | Should the album/channel be hidden or not. (Only available on 23 Video.) Default is 0 Allowed values: 0 or 1 |
user_id | The user's ID. If no user ID is given, the objects will be uploaded anonymously. Requires super, otherwise albums are created by the authenticated user. |
Permission level
The minimum required permission level is:
write
Example XML Response
<response status="ok" permission_level="write"
message="The album was successfully created" cached="0">
<album_id>123456</album_id>
<token>hqzry7xaaekyavpjghpZkt1ykbelKjai</token>
</response>
Example JSON Response
{
"status": "ok",
"message":"The album was successfully created",
"permission_level":"write",
"cached":"0",
"album":{"album_id": "123456", "token": "hqzry7xaaekyavpjghpZkt1ykbelKjai"},
"p": "1",
"size": "1",
"site": { ...},
"endpoint": "/api/album/create"
}