Artist knowledge

Artist brief

Use stored facts and a generated navigation summary to choose evidence to inspect; no generation, source fetch or job enqueue. Current history/constraints must be loaded separately.

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

GET

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

Use stored facts and a generated navigation summary to choose evidence to inspect; no generation, source fetch or job enqueue. Current history/constraints must be loaded separately.

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.

cURL

curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/{id}/knowledge/brief'

Send the request to see the live response here.

cURL

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

{
  "status": "ok",
  "artistId": "YOUR_ID",
  "summaryIsEvidence": true,
  "coverage": {
    "eligibleSources": 0,
    "readableSources": 0,
    "searchedSources": 0,
    "complete": true,
    "limitations": [
      "string"
    ]
  },
  "historyRequired": true,
  "returnedChars": 0,
  "truncated": 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.

Response

application/json

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

statusstring · enumrequired

Values: "ok"

artistIdstringrequired

format: uuid

namestring | nullrequired

biostring | nullrequired

generatedLoreSummarystring | nullrequired

summaryIsEvidencebooleanrequired

coverageobjectrequired

Coverage of stored eligible records, not a claim that all external material or PDF pages were extracted. For non-search reads, searchedSources is zero. Legacy extraction limits must be explicit.

Properties

eligibleSourcesintegerrequired

minimum: 0

readableSourcesintegerrequired

minimum: 0

searchedSourcesintegerrequired

minimum: 0

completebooleanrequired

limitationsarray<string>required

Item properties

string

historyRequiredbooleanrequired

returnedCharsintegerrequired

minimum: 0 · maximum: 6000

truncatedbooleanrequired