Interview memory and sessions
Read question preparation Read-only status for the session’s next question. Does not generate, enqueue or write. Stale means the session, claim, next ordinal or mandatory memory no longer matches the prepared candidate. A consumed preparation returns idle without jobId. A ready candidate is not a saved offer. Actual current approved claimant only; administrator status alone is insufficient. Bearer authentication is verified on every request; bearer tokens are never stored in the job. Private/no-store. Approved claims may automatically queue private question preparation after source research. The artist still explicitly chooses Start before any question is offered. Existing jobs wait for readable approved originals or artist-owned social text; pending Lore alone is not usable evidence. Existing readable artist context can proceed without waiting for unrelated Latest or ongoing research jobs. Waiting runs no model or scrape. Automatic waiting stops after 24 hours, and the same job becomes eligible again when usable evidence appears. Exact claimant ownership is rechecked before preparing. Reading pages or GET status never queues this work.
GET / api/ artist/ {artistId} / interview/ session/ {sessionId} / prepare
Try it Endpoint GET 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 GET / api/ artist/ {artistId} / interview/ session/ {sessionId} / prepare
Send Read-only status for the session’s next question. Does not generate, enqueue or write. Stale means the session, claim, next ordinal or mandatory memory no longer matches the prepared candidate. A consumed preparation returns idle without jobId. A ready candidate is not a saved offer. Actual current approved claimant only; administrator status alone is insufficient. Bearer authentication is verified on every request; bearer tokens are never stored in the job. Private/no-store. Approved claims may automatically queue private question preparation after source research. The artist still explicitly chooses Start before any question is offered. Existing jobs wait for readable approved originals or artist-owned social text; pending Lore alone is not usable evidence. Existing readable artist context can proceed without waiting for unrelated Latest or ongoing research jobs. Waiting runs no model or scrape. Automatic waiting stops after 24 hours, and the same job becomes eligible again when usable evidence appears. Exact claimant ownership is rechecked before preparing. Reading pages or GET status never queues this work.
Authorization Path curl --request GET \
--url 'https://musicnerd-api.vercel.app/api/artist/{artistId}/interview/session/{sessionId}/prepare'
Send the request to see the live response here.
curl --request GET \
--url 'https://musicnerd-api.vercel.app/api/artist/YOUR_ARTIST_ID/interview/session/YOUR_SESSION_ID/prepare' \
--header 'Authorization: Bearer YOUR_TOKEN'
{
"status" : "ok" ,
"preparation" : {
"status" : "idle"
}
}
Authorizations Authorizationstring header required
Bearer authentication header of the form Bearer <token>.
Response Status 200 400 401 403 404 409 503 application/json Current preparation status. A ready candidate has not been offered yet.
preparationobject required
Properties for preparation jobIdstring
Present when a preparation job exists.
format: uuid
statusstring · enum required
Values: "idle", "pending", "running", "ready", "failed", "stale"
errorCodestring · enum
Safe failure classification only; never raw provider errors or private job payloads.
Values: "preparation_failed", "model_output_invalid", "timeout_or_cancelled", "external_outcome_unknown"
readyCountinteger
Number of independently checked available questions. Zero while initial preparation or eligibility checking is pending.
minimum: 0 · maximum: 3
totalCountinteger
Questions targeted by this preparation bank; a new sitting targets three, an existing sitting only remaining slots.
minimum: 1 · maximum: 3
phasestring · enum
Preparing generates the initial bank; checking revalidates saved questions after an answer or changed instructions without generating replacements.
Values: "preparing", "checking"