music nerd

Interview memory and sessionsRestore the interview

Interview memory and sessions

Restore the interview

The saved interview state, and for an active sitting with nothing offered and no legacy offers, its current preparation. Nothing is generated, queued or written.

GET/api/artist/{id}/interview
GET/api/artist/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/interview

The saved interview state, and for an active sitting with nothing offered and no legacy offers, its current preparation. Nothing is generated, queued or written.

Authorization

Authorizationstringrequired

Kept in this tab only.

Path

idstringrequired

The artist's ID (a UUID).

cURL
curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/interview'

Send the request to see the live response here.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>.

Path Parameters

idstringrequired

The artist's ID (a UUID).

Response

application/json

The saved interview. Cache-Control: private, no-store.

statusanyrequired
sessionobject | nullrequired
Properties for session
idstring

format: uuid

sittinginteger
statestring · enum

Values: "active", "finished"

createdAtstring

format: date-time

closedAtstring | null

format: date-time

questionsarray<object>

maxItems: 3

Item properties for questions
idstring

format: uuid

questionKeystring
questionstring
answerstring | null
statestring · enum

Values: "offered", "answered", "skipped"

revisionstring

pattern: ^[a-f0-9]{64}$

sittinginteger
offeredAtstring

format: date-time

answerUpdatedAtstring

format: date-time

ordinalinteger | null
referencesarray<object>
Item properties for references
kindstring · enumrequired

Values: "original", "answer"

sourceIdstring

Required for original evidence: full vault/social source identity.

entryIdstring

Required for answer evidence: full answer identity.

revisionstringrequired

pattern: ^[a-f0-9]{64}$

startintegerrequired

UTF-16 offset.

minimum: 0

endintegerrequired

minimum: 1

quotestringrequired

minLength: 8 · maxLength: 1600

interviewInvalidatedboolean

True after changed instructions invalidate the fixed offered bank. Saved answers remain intact; finish explicitly before starting a new sitting.

needsPreparedBankResumeboolean

Read-only hint that an active legacy sitting has an offered question and remaining checked bank items. On explicit Resume, call consume to revalidate current ownership, mandatory memory, and evidence and atomically offer eligible remaining questions. GET never offers questions. False for fully offered banks.

legacyOffersarray<object>required

maxItems: 3

Item properties for legacyOffers
idstring

format: uuid

questionKeystring
questionstring
answerstring | null
statestring · enum

Values: "offered", "answered", "skipped"

revisionstring

pattern: ^[a-f0-9]{64}$

sittinginteger
offeredAtstring

format: date-time

answerUpdatedAtstring

format: date-time

ordinalinteger | null
referencesarray<object>
Item properties for references
kindstring · enumrequired

Values: "original", "answer"

sourceIdstring

Required for original evidence: full vault/social source identity.

entryIdstring

Required for answer evidence: full answer identity.

revisionstringrequired

pattern: ^[a-f0-9]{64}$

startintegerrequired

UTF-16 offset.

minimum: 0

endintegerrequired

minimum: 1

quotestringrequired

minLength: 8 · maxLength: 1600

preparationobject

Present after start and prepare (the queued preparation), and on a restore of an active sitting with no offered question (its current preparation).

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"

savedQuestionobject

Present after answer: the question as saved.

Properties for savedQuestion
idstring

format: uuid

questionKeystring
questionstring
answerstring | null
statestring · enum

Values: "offered", "answered", "skipped"

revisionstring

pattern: ^[a-f0-9]{64}$

sittinginteger
offeredAtstring

format: date-time

answerUpdatedAtstring

format: date-time

ordinalinteger | null
referencesarray<object>
Item properties for references
kindstring · enumrequired

Values: "original", "answer"

sourceIdstring

Required for original evidence: full vault/social source identity.

entryIdstring

Required for answer evidence: full answer identity.

revisionstringrequired

pattern: ^[a-f0-9]{64}$

startintegerrequired

UTF-16 offset.

minimum: 0

endintegerrequired

minimum: 1

quotestringrequired

minLength: 8 · maxLength: 1600