Vault uploads
Upload a file directly
Uploads a file to an artist's vault in one request, saves it as an approved source and queues a Lore refresh. Same limits and types as Sign an upload, which with Complete an upload sends the file straight to storage instead of through the API. Not runnable from this page: the body is multipart/form-data.
Body
multipart/form-datarequiredfilestringrequiredThe file, at most 10 MB. Bodies over about 4.5 MB are refused by the platform before reaching the API; use Sign an upload for larger files.
format: binary
artistIdstringrequiredThe artist's ID.
format: uuid
Response
application/jsonThe saved source. warning is set when the Lore refresh could not be queued or a PDF had no readable text.
statusstring · enumrequiredValues: "ok"
successboolean · enumrequiredAlways true on 200.
Values: true
sourceobjectrequiredA row of the artist's vault, as stored.
Properties for source
idstringrequiredformat: uuid
artistIdstringrequiredformat: uuid
originstringrequiredupload for a file the claimant or an admin uploaded.
activityIdstring | nullThe activity event that recorded the upload.
format: uuid
urlstringrequiredThe file's public URL in storage.
format: uri
titlestring | nullThe file's name.
snippetstring | nullThe first 300 characters of extracted text, or Uploaded file: <name> when there is none.
typestring | nullimage and audio by MIME type, data for CSV and JSON, document otherwise.
Values: "document", "data", "image", "audio", null
statusstring · enumrequiredAlways approved for an upload.
Values: "pending", "approved", "rejected"
fileNamestring | nullfileSizeinteger | nullBytes.
filePathstring | nullThe storage key (<artistId>/<name>), not the URL.
contentTypestring | nullThe resolved MIME type.
extractedTextstring | nullThe file's text, for text files and PDFs with readable text.
ogImagestring | nullpodcastEpisodeKeystring | nullpodcastShowTitlestring | nullpodcastEpisodeTitlestring | nullpublishedAtstring | nullformat: date
createdAtstringrequiredupdatedAtstring | nullwarningstringAdvice to show the user. Absent when there is none.