Interview memory and sessions

Finish interview sitting

Explicitly closes a sitting, skips an unanswered offer and queues an existing durable Lore refresh for its answers in the same transaction. Repeated finish is idempotent. It never runs a detached model call. Current claimant or administrator only. Private/no-store. Requires staging-verified migrations 0041 and 0042 before deployment. Draft; not released.

POST/api/artist/{id}/interview/session/{sessionId}/finish

POST

POST/api/artist/{id}/interview/session/{sessionId}/finish

Authorization

Authorizationstringrequired

Kept in this tab only.

Bearer

Path

idstringrequired

sessionIdstringrequired

Body

bodyapplication/json

cURL

curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/artist/{id}/interview/session/{sessionId}/finish' \
  --header 'Content-Type: application/json' \
  --data '{}'

Send the request to see the live response here.

cURL

curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/artist/YOUR_ID/interview/session/YOUR_SESSION_ID/finish' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "session": {
    "id": "YOUR_ID",
    "sitting": 0,
    "state": "active",
    "createdAt": "string",
    "questions": [
      {
        "id": "YOUR_ID",
        "questionKey": "string",
        "question": "string",
        "state": "offered",
        "revision": "string",
        "sitting": 0,
        "offeredAt": "string",
        "answerUpdatedAt": "string",
        "references": [
          {}
        ]
      }
    ]
  },
  "legacyOffers": [
    {
      "id": "YOUR_ID",
      "questionKey": "string",
      "question": "string",
      "state": "offered",
      "revision": "string",
      "sitting": 0,
      "offeredAt": "string",
      "answerUpdatedAt": "string",
      "references": [
        {
          "kind": "original",
          "revision": "string",
          "start": 0,
          "end": 1,
          "quote": "string"
        }
      ]
    }
  ]
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>.

Path Parameters

idstringrequired

sessionIdstringrequired

Body

application/jsonrequired

object

Response

application/json

Exact saved state.

statusany

sessionobject | null

Properties

idstring

format: uuid

sittinginteger

statestring · enum

Values: "active", "finished"

createdAtstring

format: date-time

closedAtstring | null

format: date-time

questionsarray<object>

maxItems: 3

Item properties

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

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

legacyOffersarray<object>

maxItems: 3

Item properties

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

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