# Recently edited artists

Source: https://docs.musicnerd.net/api-reference/activity/recent-edited

Recently edited artists

## GET /api/recentEdited

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

## Authentication

This operation's specification permits a request without authentication.

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

## Operation and referenced schemas

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Music Nerd API: activity and contributions",
    "version": "1.0.0",
    "description": "The public activity feed and a signed-in user's own contributions: their recent edits, profile edits, submission counts and submissions."
  },
  "servers": [
    {
      "url": "https://musicnerd-api.vercel.app",
      "description": "Production"
    },
    {
      "url": "https://musicnerd-api-staging.vercel.app",
      "description": "Staging (staging database)"
    }
  ],
  "paths": {
    "/api/recentEdited": {
      "get": {
        "summary": "Recently edited artists",
        "operationId": "getRecentEdited",
        "security": [
          {
            "privyBearer": []
          },
          {}
        ],
        "description": "The last three distinct artists a user's approved submissions touched, each with an image. Pass `userId` for any user; without it the signed-in user's own are returned. With neither, or when the read fails, the list is empty.",
        "parameters": [
          {
            "name": "userId",
            "in": "query",
            "required": false,
            "description": "The user whose edits to list. Omit for the signed-in user.",
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "0f3c5e1a-9b7d-4c2e-8a6f-1d2e3f4a5b6c"
          }
        ],
        "responses": {
          "200": {
            "description": "Up to three artists, most recently edited first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecentEdited"
                },
                "examples": {
                  "withEdits": {
                    "summary": "A contributor with approved edits",
                    "value": {
                      "status": "ok",
                      "entries": [
                        {
                          "ugcId": "c9d8e7f6-a5b4-4c3d-9e2f-1a0b9c8d7e6f",
                          "artistId": "aab92f80-f9e1-4299-aa33-7dd85c8de5d3",
                          "updatedAt": "2026-10-20 18:41:07.512",
                          "artistName": "Bio Ritmo",
                          "spotifyId": "3pZWMMjXnxbcxurOCYK5sL",
                          "deezerId": null,
                          "customImage": null,
                          "imageUrl": "https://i.scdn.co/image/ab6761610000e5eb1a2b3c4d5e6f7a8b9c0d1e2f"
                        }
                      ]
                    }
                  },
                  "empty": {
                    "summary": "No user given and no token, or no approved edits",
                    "value": {
                      "status": "ok",
                      "entries": []
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "RecentEdited": {
        "type": "object",
        "required": [
          "status",
          "entries"
        ],
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "ok"
            ]
          },
          "entries": {
            "type": "array",
            "maxItems": 3,
            "description": "Most recently edited first.",
            "items": {
              "$ref": "#/components/schemas/RecentEditedArtist"
            }
          }
        }
      },
      "RecentEditedArtist": {
        "type": "object",
        "required": [
          "ugcId",
          "artistId",
          "updatedAt",
          "artistName",
          "spotifyId",
          "deezerId",
          "customImage",
          "imageUrl"
        ],
        "properties": {
          "ugcId": {
            "type": "string",
            "format": "uuid",
            "description": "The most recent approved submission for this artist."
          },
          "artistId": {
            "type": "string",
            "format": "uuid"
          },
          "updatedAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "When that submission was last updated."
          },
          "artistName": {
            "type": [
              "string",
              "null"
            ]
          },
          "spotifyId": {
            "type": [
              "string",
              "null"
            ]
          },
          "deezerId": {
            "type": [
              "string",
              "null"
            ]
          },
          "customImage": {
            "type": [
              "string",
              "null"
            ],
            "description": "The artist's own uploaded image URL, as stored."
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "The image to show: the upload, else Spotify's, else Deezer's 250 px picture, else null."
          }
        }
      }
    },
    "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."
      }
    }
  }
}
```
