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.
Path Parameters
idstringrequiredThe artist's ID (a UUID).
Response
application/jsonThe saved interview. Cache-Control: private, no-store.
statusanyrequiredsessionobject | nullrequiredProperties for session
idstringformat: uuid
sittingintegerstatestring · enumValues: "active", "finished"
createdAtstringformat: date-time
closedAtstring | nullformat: date-time
questionsarray<object>maxItems: 3
Item properties for questions
idstringformat: uuid
questionKeystringquestionstringanswerstring | nullstatestring · enumValues: "offered", "answered", "skipped"
revisionstringpattern: ^[a-f0-9]{64}$
sittingintegerofferedAtstringformat: date-time
answerUpdatedAtstringformat: date-time
ordinalinteger | nullreferencesarray<object>Item properties for references
kindstring · enumrequiredValues: "original", "answer"
sourceIdstringRequired for original evidence: full vault/social source identity.
entryIdstringRequired for answer evidence: full answer identity.
revisionstringrequiredpattern: ^[a-f0-9]{64}$
startintegerrequiredUTF-16 offset.
minimum: 0
endintegerrequiredminimum: 1
quotestringrequiredminLength: 8 · maxLength: 1600
interviewInvalidatedbooleanTrue after changed instructions invalidate the fixed offered bank. Saved answers remain intact; finish explicitly before starting a new sitting.
needsPreparedBankResumebooleanRead-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>requiredmaxItems: 3
Item properties for legacyOffers
idstringformat: uuid
questionKeystringquestionstringanswerstring | nullstatestring · enumValues: "offered", "answered", "skipped"
revisionstringpattern: ^[a-f0-9]{64}$
sittingintegerofferedAtstringformat: date-time
answerUpdatedAtstringformat: date-time
ordinalinteger | nullreferencesarray<object>Item properties for references
kindstring · enumrequiredValues: "original", "answer"
sourceIdstringRequired for original evidence: full vault/social source identity.
entryIdstringRequired for answer evidence: full answer identity.
revisionstringrequiredpattern: ^[a-f0-9]{64}$
startintegerrequiredUTF-16 offset.
minimum: 0
endintegerrequiredminimum: 1
quotestringrequiredminLength: 8 · maxLength: 1600
preparationobjectPresent 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
jobIdstringPresent when a preparation job exists.
format: uuid
statusstring · enumrequiredValues: "idle", "pending", "running", "ready", "failed", "stale"
errorCodestring · enumSafe failure classification only; never raw provider errors or private job payloads.
Values: "preparation_failed", "model_output_invalid", "timeout_or_cancelled", "external_outcome_unknown"
readyCountintegerNumber of independently checked available questions. Zero while initial preparation or eligibility checking is pending.
minimum: 0 · maximum: 3
totalCountintegerQuestions targeted by this preparation bank; a new sitting targets three, an existing sitting only remaining slots.
minimum: 1 · maximum: 3
phasestring · enumPreparing generates the initial bank; checking revalidates saved questions after an answer or changed instructions without generating replacements.
Values: "preparing", "checking"
savedQuestionobjectPresent after answer: the question as saved.
Properties for savedQuestion
idstringformat: uuid
questionKeystringquestionstringanswerstring | nullstatestring · enumValues: "offered", "answered", "skipped"
revisionstringpattern: ^[a-f0-9]{64}$
sittingintegerofferedAtstringformat: date-time
answerUpdatedAtstringformat: date-time
ordinalinteger | nullreferencesarray<object>Item properties for references
kindstring · enumrequiredValues: "original", "answer"
sourceIdstringRequired for original evidence: full vault/social source identity.
entryIdstringRequired for answer evidence: full answer identity.
revisionstringrequiredpattern: ^[a-f0-9]{64}$
startintegerrequiredUTF-16 offset.
minimum: 0
endintegerrequiredminimum: 1
quotestringrequiredminLength: 8 · maxLength: 1600