# Updates from your artists

Source: https://docs.musicnerd.net/api-reference/users/profile-updates

Updates from your artists

## GET /api/profile/updates

Full OpenAPI specification: https://docs.musicnerd.net/spec/users.json

## Authentication

This operation requires one of the security alternatives in the specification below. Security scheme definitions are included where present in the published specification.

[Authentication guide](https://docs.musicnerd.net/authentication)

## Operation and referenced schemas

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Music Nerd API: users and profile",
    "version": "1.0.0",
    "description": "The signed-in user's own account and profile: their user name, profile photo, approved claim, contributed artists, contribution summary and the updates feed. Every route answers about the caller only; the account comes from the token, never from the request."
  },
  "servers": [
    {
      "url": "https://musicnerd-api.vercel.app",
      "description": "Production"
    },
    {
      "url": "https://musicnerd-api-staging.vercel.app",
      "description": "Staging (staging database)"
    }
  ],
  "paths": {
    "/api/profile/updates": {
      "get": {
        "summary": "Updates from your artists",
        "operationId": "getProfileUpdates",
        "security": [
          {
            "privyBearer": []
          }
        ],
        "description": "The latest cards from the caller's artists, six artists per page in the same order as [Your artists](/api-reference/users/profile-artists), up to two per artist, newest first. Built from the stored [artist Latest](/api-reference/artists/latest): releases, Instagram posts, In Process moments and published interview answers, with a missing or failed snapshot reported in `unavailableProviders`. `checked` is how many artists have been read so far; `next` is the `offset` for the next six.",
        "parameters": [
          {
            "$ref": "#/components/parameters/ProfileAccountRequired"
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "The artist to start from, in the caller's artist order. Up to six digits; defaults to 0.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{1,6}$",
              "default": "0"
            },
            "example": "0"
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "description": "Which cards to keep. `All`, `Release`, `Socials` (Instagram posts and In Process moments) or `Lore` (interview answers); `Instagram`, `Interview` and `In-Process` are older filter names that still work.",
            "schema": {
              "type": "string",
              "enum": [
                "All",
                "Release",
                "Socials",
                "Lore",
                "Instagram",
                "Interview",
                "In-Process"
              ],
              "default": "All"
            },
            "example": "All"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of cards. `Cache-Control: private, no-store`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "userId",
                    "items",
                    "checked",
                    "next",
                    "unavailable",
                    "unavailableProviders"
                  ],
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "ok"
                      ]
                    },
                    "userId": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ProfileUpdate"
                      }
                    },
                    "checked": {
                      "type": "integer",
                      "description": "How many of the caller's artists have been read, this page included."
                    },
                    "next": {
                      "type": [
                        "integer",
                        "null"
                      ],
                      "description": "The `offset` for the next page, or null once every artist has been read."
                    },
                    "unavailable": {
                      "type": "boolean",
                      "description": "True when at least one artist's Latest could not be fully read."
                    },
                    "unavailableProviders": {
                      "type": [
                        "array",
                        "null"
                      ],
                      "description": "Which providers were failed or missing, sorted; null when a read failed for an unknown reason.",
                      "items": {
                        "type": "string",
                        "enum": [
                          "spotify",
                          "deezer",
                          "inprocess"
                        ]
                      }
                    }
                  }
                },
                "example": {
                  "status": "ok",
                  "userId": "6f1d2e3a-4b5c-4d6e-8f90-a1b2c3d4e5f6",
                  "items": [
                    {
                      "id": "aab92f80-f9e1-4299-aa33-7dd85c8de5d3:release:spotify:4uLU6hMCjMI75M1A2tKUQC",
                      "kind": "release",
                      "title": "Mambo Mania",
                      "text": "album",
                      "date": "2026-09-12",
                      "imageUrl": "https://i.scdn.co/image/example",
                      "imageCaption": "Mambo Mania artwork",
                      "sourceUrl": "https://open.spotify.com/album/4uLU6hMCjMI75M1A2tKUQC",
                      "sourceLabel": "Listen on Spotify",
                      "artistId": "aab92f80-f9e1-4299-aa33-7dd85c8de5d3",
                      "artistName": "Bio Ritmo"
                    }
                  ],
                  "checked": 1,
                  "next": null,
                  "unavailable": false,
                  "unavailableProviders": []
                }
              }
            }
          },
          "400": {
            "description": "`offset` isn't one to six digits, or `kind` isn't a known filter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "offset": {
                    "summary": "Bad offset",
                    "value": {
                      "status": "error",
                      "error": "Invalid offset"
                    }
                  },
                  "kind": {
                    "summary": "Unknown filter",
                    "value": {
                      "status": "error",
                      "error": "Invalid filter"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/NotSignedIn"
          },
          "409": {
            "$ref": "#/components/responses/AccountChanged"
          },
          "503": {
            "description": "The caller's artists could not be read.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "status": "error",
                  "error": "Could not load artist updates"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "ProfileAccountRequired": {
        "name": "X-Profile-Account",
        "in": "header",
        "required": true,
        "description": "The user id the page believes is signed in. Must equal the token's user, or the response is 409 so the page can refresh instead of showing another account's data.",
        "schema": {
          "type": "string",
          "format": "uuid"
        },
        "example": "6f1d2e3a-4b5c-4d6e-8f90-a1b2c3d4e5f6"
      }
    },
    "schemas": {
      "ProfileUpdate": {
        "type": "object",
        "description": "A stored Latest card (see the artist Latest endpoint) with the artist it belongs to. `id` is prefixed with the artist id so cards from different artists never collide.",
        "required": [
          "id",
          "kind",
          "title",
          "text",
          "date",
          "imageUrl",
          "imageCaption",
          "sourceUrl",
          "sourceLabel",
          "artistId",
          "artistName"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "release",
              "instagram",
              "interview",
              "moment"
            ]
          },
          "title": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "date": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "imageDimensions": {
            "type": "object",
            "properties": {
              "width": {
                "type": "number"
              },
              "height": {
                "type": "number"
              }
            }
          },
          "imageCaption": {
            "type": "string"
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "sourceLabel": {
            "type": "string"
          },
          "momentKind": {
            "type": "string",
            "enum": [
              "video",
              "audio",
              "image",
              "writing",
              "other"
            ]
          },
          "listeningLinks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "siteName": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "href": {
                  "type": "string"
                },
                "iconSrc": {
                  "type": "string"
                }
              }
            }
          },
          "artistId": {
            "type": "string",
            "format": "uuid"
          },
          "artistName": {
            "type": "string"
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "status",
          "error"
        ],
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "error"
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    },
    "responses": {
      "NotSignedIn": {
        "description": "No token, an invalid or expired token, or no Music Nerd user for it.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "status": "error",
              "error": "Not signed in"
            }
          }
        }
      },
      "AccountChanged": {
        "description": "`X-Profile-Account` is missing or is not the caller's id.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "status": "error",
              "error": "Account changed. Refresh and try again."
            }
          }
        }
      }
    },
    "securitySchemes": {
      "privyBearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Access token",
        "description": "The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. Every route here answers about that user only."
      }
    }
  }
}
```
