A photo album.

id
string

Unique (server-wide) identifier of this photo album.

ap_id
string

Globally-unique ActivityPub identifier for this album. Use this to match albums across servers.

url
string

The URL of the web page representing this album. For albums owned by remote actors, points to their home server.

owner_id
integer

User identifier or minus group identifier of this album’s owner.

is_system
boolean

Whether this is a system album. System albums are those which have special purposes, like “profile pictures” or “saved photos”. They can’t be edited or deleted, and photos can’t be arbitrarily uploaded to them.

title
string

The title of this album.

description
string

The description of this album.

cover_id
string

Identifier of the photo which is this album’s cover.

created
integer

The unixtime timestamp when this album was created.

updated
integer

The unixtime timestamp when this album was last updated.

size
integer

The number of photos in this album.

cover
photo

If need_covers was true, an object representing this album’s cover photo.

Current user's non-system albums only

privacy_view
privacy setting

Privacy setting determining who can see this album.

privacy_comment
privacy setting

Privacy setting determining who can comment on photos in this album.

Non-system group albums only

can_upload
boolean

Whether the current user can upload new photos to this album.

Non-system albums in managed groups only

uploads_by_admins_only
boolean

Whether uploading new photos to this album is restricted to the group managers.

comments_disabled
boolean

Whether commenting on photos in this album is disabled.