Skip to content
Log in
Developer API
Get your keyGet a key

Reference · Library

GET/library

What the account made, uploaded and saved

The person’s Library, by its tabs: made (the default) — everything made here, newest first, across every studio and board: pictures, videos, audio (music and voiceovers), motion (stories), with the words each was made from and the model — or uploads — the files they brought in, uploaded to any tool or from a link, most recently used first, with their name, size, shape or length. Each with a link (good for about 7 days). Page with cursor. To use one in a create tool, pass its useAs to POST /api/v1/library/use: {kind: "library", source, id} for a piece made here, {kind: "upload", id} for a file they brought in. Free.

Key needs
account:read · See your account
Spends
Nothing
Answers
Data
Request
curl https://vessero.com/api/v1/library \
  -H "Authorization: Bearer $VESSERO_API_KEY"

Query

  • tabstringmade (the default): what they made here. uploads: the files they brought in (from the upload window, a link, or any page).madeuploads
  • kindstringOnly this kind. Made: image, video, audio (music and voiceovers), motion (stories), or upload (files dropped on boards before the Uploads tab). Uploads: image, video, audio.imagevideoaudiomotionupload
  • sourcestringMade only: where it was made — studio (the create pages), board, or series (stories and automation).studioboardseries
  • searchstringWords in its name, or in the words it was made from, e.g. "logo" or "tote".
  • limitintegerHow many, 1–96. Default 20.
  • cursorstringThe nextCursor of the previous page of the same tab; leave it out for the first.

Answers

  • 200okThe answer, as data.
  • 404not_foundNot found on this account.
  • 429rate_limitedToo many calls this minute: see Retry-After.
Next in LibraryPOST/library/use