Vault uploads
Complete an upload Step two of a file upload: checks the staged file against its ticket, publishes it to the artist's vault as an approved source, queues a Lore refresh and returns the saved source. Completing the same ticket again returns the saved source. A retryCompletion: true error means the same ticket should be sent again, not a new upload started.
POST / api/ vault/ upload/ complete
Try it Endpoint POST Check health Read stored artist Latest Read the Update Latest request Request an Update Latest check Advance research Run the research scheduler Look again Request question research Read question research Continue question research Review queue Review a discovery Read research original Chat about an artist Start the claim build Onboarding state Reset the claim build Onboarding chat turn Artist brief List artist sources Search original evidence Read an original source Interview history Research status Recover missing source text Read mandatory interview memory List active interview boundaries Save an explicit interview boundary Retract an interview boundary Restore saved interview Start interview sitting Read question preparation Prepare or offer the next question Save prepared question Save exact interview answer Finish interview sitting Restore the interview Run an interview action List saved interview responses Read an exact response Revise a saved response Review response versions Find an artist by Spotify ID Find an artist by Instagram handle Find an artist's X handle Search artists Find a track on other services Read the contributor leaderboard Redirect to an artist's image Send an MCP message MCP resource metadata Authorization server metadata Register a client Start authorization Get a token Read a connection request Approve or deny an agent List connected agents Disconnect an agent Check a team member Read the signed-in account Read your account Set your user name Record the user-name prompt Your approved claim Your profile photo Upload your profile photo Your artists Your contribution summary Updates from your artists Claim an artist profile Approve a claim Reject a claim Revoke a claim Link a wallet Read the About Save or regenerate the About Report a problem with the About Suggest a Lore source Directory discovery status Export the Lore document Activity feed Recently edited artists Profile edit history Submission count Submitted links Save the artist's link order Set or clear an artist link Remove an artist link Check a profile link is live List platform URL patterns List link suggestions Review a link suggestion Artist data Review an About correction report Read the About for a report Save the About for a report Pending UGC count Photo choices Choose a provider photo Upload a profile image Set the header position Sign an upload Complete an upload Upload a file directly POST / api/ vault/ upload/ complete
Send Step two of a file upload: checks the staged file against its ticket, publishes it to the artist's vault as an approved source, queues a Lore refresh and returns the saved source. Completing the same ticket again returns the saved source. A retryCompletion: true error means the same ticket should be sent again, not a new upload started.
Authorization Body bodyapplication/json
curl --request POST \
--url 'https://musicnerd-api.vercel.app/api/vault/upload/complete' \
--header 'Content-Type: application/json' \
--data '{
"ticket": "eyJ1c2VySWQiOi…fQ.3b2a9c…"
}'
Send the request to see the live response here.
curl --request POST \
--url 'https://musicnerd-api.vercel.app/api/vault/upload/complete' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"ticket": "eyJ1c2VySWQiOi…fQ.3b2a9c…"
}'
{
"status" : "ok" ,
"source" : {
"id" : "2c6f1c6e-4f0a-4b9b-8a6a-3b1f0b2d9e71" ,
"artistId" : "aab92f80-f9e1-4299-aa33-7dd85c8de5d3" ,
"origin" : "upload" ,
"activityId" : "5d1e3a0c-7b2f-4c8e-9a1d-0e2f3a4b5c6d" ,
"url" : "https://example.supabase.co/storage/v1/object/public/vault-files/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/7f8f0a3e-0c8a-4b65-9f0e-1b1c2d3e4f50_press-kit.pdf" ,
"title" : "press-kit.pdf" ,
"snippet" : "Bio Ritmo is a ten-piece salsa band from Richmond, Virginia…" ,
"type" : "document" ,
"status" : "approved" ,
"fileName" : "press-kit.pdf" ,
"fileSize" : 482133 ,
"filePath" : "aab92f80-f9e1-4299-aa33-7dd85c8de5d3/7f8f0a3e-0c8a-4b65-9f0e-1b1c2d3e4f50_press-kit.pdf" ,
"contentType" : "application/pdf" ,
"extractedText" : "Bio Ritmo is a ten-piece salsa band from Richmond, Virginia…" ,
"ogImage" : null ,
"podcastEpisodeKey" : null ,
"podcastShowTitle" : null ,
"podcastEpisodeTitle" : null ,
"publishedAt" : null ,
"createdAt" : "2026-10-21 18:04:11.512+00" ,
"updatedAt" : "2026-10-21 18:04:11.512+00"
}
}
Authorizations Authorizationstring header required
Bearer authentication header of the form Bearer <token>. The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. The user must be the artist's approved claimant or a Music Nerd admin.
Body application/json required ticketstring required
The ticket from Sign an upload.
Response Status 200 400 401 403 500 503 application/json The saved source. warning is set when the Lore refresh could not be queued (the file is saved) or when a PDF had no readable text.
statusstring · enum required
Values: "ok"
sourceobject required
A row of the artist's vault, as stored.
Properties for source idstring required
format: uuid
artistIdstring required
format: uuid
originstring required
upload for a file the claimant or an admin uploaded.
activityIdstring | null
The activity event that recorded the upload.
format: uuid
urlstring required
The file's public URL in storage.
format: uri
snippetstring | null
The first 300 characters of extracted text, or Uploaded file: <name> when there is none.
typestring | null
image and audio by MIME type, data for CSV and JSON, document otherwise.
Values: "document", "data", "image", "audio", null
statusstring · enum required
Always approved for an upload.
Values: "pending", "approved", "rejected"
filePathstring | null
The storage key (<artistId>/<name>), not the URL.
extractedTextstring | null
The file's text, for text files and PDFs with readable text.
podcastEpisodeKeystring | null
podcastShowTitlestring | null
podcastEpisodeTitlestring | null
publishedAtstring | null
format: date
warningstring
Advice to show the user. Absent when there is none.