music nerd

Interview memory and sessionsRead question preparation

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
GET/api/artist/{artistId}/interview/session/{sessionId}/prepare

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

Authorizationstringrequired

Kept in this tab only.

Path

artistIdstringrequired

sessionIdstringrequired

cURL
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.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>.

Path Parameters

artistIdstringrequired
sessionIdstringrequired

Response

application/json

Current preparation status. A ready candidate has not been offered yet.

statusanyrequired
preparationobjectrequired
Properties for preparation
jobIdstring

Present when a preparation job exists.

format: uuid

statusstring · enumrequired

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"