Skip to main content
POST
Create a library

Body

application/json
name
string
required

Display name for the new library. Required.

Maximum string length: 255
description
string | null

Optional free-form description shown alongside the library name.

Maximum string length: 8192

Response

Successful Response

Represents a user's photo library.

id
string
required

Unique library identifier with 'lib_' prefix

name
string
required

Display name of the library

user_id
string
required

ID of the user who owns this library

asset_count
integer
required

Total number of assets in this library

storage_used_bytes
integer
required

Bytes of assets currently stored in this library

created_at
string<date-time>
required

When this library was created

updated_at
string<date-time>
required

When this library was last updated

description
string | null

Optional description text for the library

storage_limit_bytes
integer | null

Maximum bytes this library may store, or null if no per-library limit applies