Create an album
Changed onCreates an empty album, or reuses a matching album without changing it. The API checks names within the library, 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. Omitting the name uses the default name New Album. A new album starts empty; follow up with add_assets_to_album to populate it. A reused album may already contain assets. Does not delete existing records. To rename an existing album, use update_album instead of creating a new one.
Request
- Base URLhttps://api.gumnut.ai
- Auth
- HTTP bearer
- or HTTP bearer
Request body
Response
Existing matching album
Changes
- breaking
the
/request property's minLength was increased from0to1 - info
added the non-success response with the status
- info
added the non-success response with the status
- info
added the success response with the status
- breaking
- breaking
response property
detaillist-of-types was widened by adding typesstringto media typeapplication/jsonof response422 - info
the response property
became required for the status
- breaking