Artist knowledge

Interview history

Artist-scoped exact answer/correction field slices, corrections first, then offer order and ID. Current correction traversal completeness is separate from unavailable durable boundaries. The client supplies the latest exact unsaved answer independently.

GET/api/artist/{id}/knowledge/history

GET

GET/api/artist/{id}/knowledge/history

Authorization

Authorizationstringrequired

Existing authenticated Music Nerd user, approved artist claimant or admin. Credentials remain outside model arguments. Kept in this tab only.

Bearer

Path

idstringrequired

Artist ID in this deployment environment. Authorize claimant/admin on each call.

Query

limitinteger

Maximum records; response character/byte budgets may require an earlier continuation.

cursorstring

Opaque artist/filter-bound continuation. A changed ordered corpus returns 409.

maxCharsinteger

Text budget; a long entry returns explicit continuation.

kindstring

Filter history; defaults to all. Answer-only traversal cannot claim current constraints are loaded.

sittinginteger

Restrict answers to this sitting; current corrections remain included unless kind=answers.

cURL

curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/{id}/knowledge/history?limit=20&maxChars=12000'

Send the request to see the live response here.

cURL

curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/YOUR_ID/knowledge/history' \
  --header 'Authorization: Bearer YOUR_TOKEN'

{
  "status": "ok",
  "entries": [
    {
      "entryId": "string",
      "revision": "string",
      "kind": "answer",
      "answerState": "answered",
      "fields": [
        {
          "field": "question",
          "start": 0,
          "end": 0,
          "totalChars": 0,
          "complete": true
        }
      ]
    }
  ],
  "budget": {
    "returnedChars": 0,
    "truncated": true
  },
  "constraintsComplete": true,
  "memory": {
    "boundaryState": "string",
    "latestAnswer": {
      "entryId": "string",
      "revision": "string"
    }
  },
  "correctionsComplete": true
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>. Existing authenticated Music Nerd user, approved artist claimant or admin. Credentials remain outside model arguments.

Path Parameters

idstringrequired

Artist ID in this deployment environment. Authorize claimant/admin on each call.

Query Parameters

limitinteger

Maximum records; response character/byte budgets may require an earlier continuation.

Default: 20

cursorstring

Opaque artist/filter-bound continuation. A changed ordered corpus returns 409.

maxCharsinteger

Text budget; a long entry returns explicit continuation.

Default: 12000

kindstring · enum

Filter history; defaults to all. Answer-only traversal cannot claim current constraints are loaded.

Values: "all", "answers", "corrections"

sittinginteger

Restrict answers to this sitting; current corrections remain included unless kind=answers.

Response

application/json

Bounded stored evidence; Cache-Control: private, no-store.

statusstring · enumrequired

Values: "ok"

entriesarray<HistoryEntry>required

maxItems: 50

Item properties

entryIdstringrequired

revisionstringrequired

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

kindstring · enumrequired

Values: "answer", "correction"

questionKeystring | nullrequired

answerStateany ofrequired

Properties

anyOf · string · enum 1

string · enum · "answered", "skipped", "offered"

anyOf · null 2

null

sittinginteger | nullrequired

minimum: 1

offeredAtstring | nullrequired

format: date-time

answerUpdatedAtstring | nullrequired

format: date-time

sourcestring | nullrequired

correctionKindstring | nullrequired

fieldsarray<object>required

Verbatim field slices. Normal answers include question and answer; corrections include claim and correction. Continuation may contain one field only. Null answer remains explicit. All field text counts toward the total character budget. The cursor resumes the same entry revision and unfinished field before the next entry.

minItems: 1 · maxItems: 2

Item properties

fieldstring · enumrequired

Values: "question", "answer", "claim", "correction"

textstring | nullrequired

startintegerrequired

minimum: 0

endintegerrequired

minimum: 0

totalCharsintegerrequired

minimum: 0

completebooleanrequired

budgetobjectrequired

Properties

returnedCharsintegerrequired

minimum: 0

truncatedbooleanrequired

nextCursorstring | nullrequired

constraintsCompletebooleanrequired

False while persistent boundaries are unavailable. The client must not assume readiness from empty corrections.

memoryobjectrequired

Properties

boundaryStatestringrequired

latestAnswerany ofrequired

Properties

anyOf · object 1

entryIdstringrequired

revisionstringrequired

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

anyOf · null 2

null

correctionsCompletebooleanrequired

All current corrections traversed for this filter; does not include unavailable boundary records.