music nerd

Artist bioDirectory discovery status

Artist bio

Directory discovery status

Whether the research started when an artist was added to the directory is still running, and a fingerprint of the profile's public links that changes when they do. Only the account that added the artist, or an admin, may read it, and only within 24 hours of the artist being added.

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

Whether the research started when an artist was added to the directory is still running, and a fingerprint of the profile's public links that changes when they do. Only the account that added the artist, or an admin, may read it, and only within 24 hours of the artist being added.

Authorization

Authorizationstringrequired

The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. Each operation says who may call it: any signed-in user, or the artist's approved claimant or a Music Nerd admin. 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/directory-discovery'

Send the request to see the live response here.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>. The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. Each operation says who may call it: any signed-in user, or the artist's approved claimant or a Music Nerd admin.

Path Parameters

idstringrequired

The artist's ID (a UUID).

Response

application/json

The discovery state and the current link fingerprint. Carries Cache-Control: private, no-store.

Cache-Controlresponse header

private, no-store.

statusstring · enumrequired

Values: "ok"

statestring · enumrequired

active while directory research jobs are pending or running; complete when all finished; failed when one gave up; stopped once the artist is claimed.

Values: "active", "complete", "failed", "stopped"

revisionstringrequired

A fingerprint of the profile's public link destinations; a change means the links changed.