TwentyThree Developer APIAPI METHOD: /api/album/create

API METHOD: /api/album/create

Last updated on June 3, 2013.

Create a new album or channel.

Parameters

ParameterDescription
title (required)The album title. All HTML tags will be stripped away from the title.
descriptionDescription 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_idThe 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"
}