Research
Request an Update Latest check Queues one latest_refresh job for the artist's current connections: Instagram, In Process, Spotify and Deezer when connected, and published answers always. A live request, or one still cooling down (30 minutes), is returned instead of a second one. No provider is contacted in this request; the response is the same view as GET.
POST / api/ artist/ {id} / latest-refresh
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/ artist/ aab92f80-f9e1-4299-aa33-7dd85c8de5d3 / latest-refresh
Send Queues one latest_refresh job for the artist's current connections: Instagram, In Process, Spotify and Deezer when connected, and published answers always. A live request, or one still cooling down (30 minutes), is returned instead of a second one. No provider is contacted in this request; the response is the same view as GET.
Authorization Path curl --request POST \
--url 'https://musicnerd-api.vercel.app/api/artist/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/latest-refresh'
Send the request to see the live response here.
curl --request POST \
--url 'https://musicnerd-api.vercel.app/api/artist/YOUR_ID/latest-refresh' \
--header 'Authorization: Bearer YOUR_TOKEN'
{
"status" : "ok" ,
"refresh" : {
"id" : "6f1d2c3a-9b8e-4c7d-a6f5-1e2d3c4b5a69" ,
"status" : "pending" ,
"requestedAt" : "2026-10-21T14:02:11.000Z" ,
"sources" : {
"instagram" : {
"status" : "pending"
},
"inprocess" : {
"status" : "disconnected"
},
"spotify" : {
"status" : "checked" ,
"checkedAt" : "2026-10-21T14:02:15.000Z"
},
"deezer" : {
"status" : "disconnected"
},
"interviews" : {
"status" : "checked" ,
"checkedAt" : "2026-10-21T14:02:15.000Z"
}
},
"retryAt" : "2026-10-21T14:32:11.000Z"
}
}
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.
Path Parameters idstring required
The artist's ID (a UUID).
Response Status 200 400 401 403 503 application/json The artist's current Update Latest request, or refresh: null when there is none in scope. Cache-Control: private, no-store.
statusstring · enum required
Values: "ok"
refreshone of required
Properties for refresh oneOf · LatestRefreshView 1 idstring required
format: uuid
statusstring · enum required
Values: "pending", "running", "done", "failed"
requestedAtstring required
format: date-time
sourcesobject required
Properties for sources instagramobject required
Properties for instagram statusstring · enum required
A pending source becomes failed once the request is done or failed.
Values: "pending", "checked", "failed", "disconnected"
detailstring · enum
Instagram only; any other saved detail is withheld.
Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"
checkedAtstring
format: date-time
inprocessobject required
Properties for inprocess statusstring · enum required
A pending source becomes failed once the request is done or failed.
Values: "pending", "checked", "failed", "disconnected"
detailstring · enum
Instagram only; any other saved detail is withheld.
Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"
checkedAtstring
format: date-time
spotifyobject required
Properties for spotify statusstring · enum required
A pending source becomes failed once the request is done or failed.
Values: "pending", "checked", "failed", "disconnected"
detailstring · enum
Instagram only; any other saved detail is withheld.
Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"
checkedAtstring
format: date-time
deezerobject required
Properties for deezer statusstring · enum required
A pending source becomes failed once the request is done or failed.
Values: "pending", "checked", "failed", "disconnected"
detailstring · enum
Instagram only; any other saved detail is withheld.
Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"
checkedAtstring
format: date-time
interviewsobject required
Properties for interviews statusstring · enum required
A pending source becomes failed once the request is done or failed.
Values: "pending", "checked", "failed", "disconnected"
detailstring · enum
Instagram only; any other saved detail is withheld.
Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"
checkedAtstring
format: date-time
retryAtstring required
requestedAt plus 30 minutes; a POST before this returns the same request.
format: date-time
oneOf · null 2