music nerd

ResearchRead the Update Latest request

Research

Read the Update Latest request

Returns the artist's newest latest_refresh job that is still in scope: requested under the current approved claim by a user who still holds it, for the identities the artist has connected now. Saved identities, requester, errors and provider run IDs are never returned.

GET/api/artist/{id}/latest-refresh
GET/api/artist/aab92f80-f9e1-4299-aa33-7dd85c8de5d3/latest-refresh

Returns the artist's newest latest_refresh job that is still in scope: requested under the current approved claim by a user who still holds it, for the identities the artist has connected now. Saved identities, requester, errors and provider run IDs are never returned.

Authorization

Authorizationstringrequired

The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. The user must be 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/latest-refresh'

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. The user must be the artist's approved claimant or a Music Nerd admin.

Path Parameters

idstringrequired

The artist's ID (a UUID).

Response

application/json

The artist's current Update Latest request, or refresh: null when there is none in scope. Cache-Control: private, no-store.

statusstring · enumrequired

Values: "ok"

refreshone ofrequired
Properties for refresh
oneOf · LatestRefreshView 1
idstringrequired

The latest_refresh job.

format: uuid

statusstring · enumrequired

The job's status.

Values: "pending", "running", "done", "failed"

requestedAtstringrequired

format: date-time

sourcesobjectrequired
Properties for sources
instagramobjectrequired
Properties for instagram
statusstring · enumrequired

A pending source becomes failed once the request is done or failed.

Values: "pending", "checked", "failed", "disconnected"

detailstring · enum

Instagram only; any other saved detail is withheld.

Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"

checkedAtstring

format: date-time

inprocessobjectrequired
Properties for inprocess
statusstring · enumrequired

A pending source becomes failed once the request is done or failed.

Values: "pending", "checked", "failed", "disconnected"

detailstring · enum

Instagram only; any other saved detail is withheld.

Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"

checkedAtstring

format: date-time

spotifyobjectrequired
Properties for spotify
statusstring · enumrequired

A pending source becomes failed once the request is done or failed.

Values: "pending", "checked", "failed", "disconnected"

detailstring · enum

Instagram only; any other saved detail is withheld.

Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"

checkedAtstring

format: date-time

deezerobjectrequired
Properties for deezer
statusstring · enumrequired

A pending source becomes failed once the request is done or failed.

Values: "pending", "checked", "failed", "disconnected"

detailstring · enum

Instagram only; any other saved detail is withheld.

Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"

checkedAtstring

format: date-time

interviewsobjectrequired
Properties for interviews
statusstring · enumrequired

A pending source becomes failed once the request is done or failed.

Values: "pending", "checked", "failed", "disconnected"

detailstring · enum

Instagram only; any other saved detail is withheld.

Values: "posts_imported", "older_posts_found", "no_new_posts", "instagram_unavailable", "verifying_empty_window"

checkedAtstring

format: date-time

retryAtstringrequired

requestedAt plus 30 minutes; a POST before this returns the same request.

format: date-time

oneOf · null 2

null