Create a library
Creates an empty library, or reuses a matching live library without changing it. The API checks names within the owning user’s account, including trashed libraries, ignoring case and surrounding whitespace. Returns 201 for a new record or 200 for an existing matching name. Only supplied create fields must match; omitted fields leave existing values intact. A different supplied value returns 409 without changing the record; repeating that request does not resolve the conflict. Trashed names are reserved and return 409 until their library is purged. A new library starts empty. A library is the top-level container for assets, albums, people, and faces — most users have exactly one. Does not delete existing records. Only create a new library when the user explicitly asks for a separate container.
Authorizations
Gumnut API key (apikey_...) sent as a Bearer token in the Authorization header. Create and manage keys in the Gumnut app, or with the API key endpoints while signed in to it.
Body
Response
Existing matching library
Represents a user's photo library.
Unique library identifier with 'lib_' prefix
Display name of the library
ID of the user who owns this library
owner, viewer, collaborator Total number of assets in this library
Bytes of assets currently stored in this library
When this library was created
When this library was last updated
Optional description text for the library
Maximum bytes this library may store, or null if no per-library limit applies