PUT ​/api​/v3​/account​/:id​/artistprofile​/photo​/:photoid

Update an artist photo description or position. To change the photo itself, use the DELETE endpoint to remove the photo and the POST endpoint to upload the new photo.

Request

Example Request

{
  "auth_token": "abc1245920feab98ca",
  "photo": {
    "description": "Us looking mean in front of an abandoned warehouse",
    "position": 1
  }
}

Example Parameters

  • auth_token: The user's auth_token obtained by calling the auth API.

    • Required: yes
    • Type: string
    • Example: abc1245920feab98ca
  • photo: The photo object containing the attributes for the photo to update.

    • Required: yes
    • description: A text description of the photo
      • Required: yes
      • Type: string
      • Example: Us looking mean in front of an abandoned warehouse
    • position: The sort position for this photo.
      • Required: no
      • Type: integer
      • Example: 1

Response

Example Response

{
  "photo": {
    "id": 1,
    "description": "Us looking mean in front of an abandoned warehouse",
    "position": 1,
    "small": {
      "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/preview_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
    },
    "small_hq": {
      "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/preview_retina_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
    },
    "medium": {
      "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/small_wide_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
    },
    "medium_hq": {
      "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/small_wide_retina_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
    },
    "large": {
      "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/fullscreen_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
    },
    "large_hq": {
      "url": "https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/fullscreen_retina_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png"
    }
  }
}

Response Parameters

  • photo: Photos of the artist

    • Required: yes
    • id: The unique ID of the photo
      • Required: yes
      • Type: integer
      • Example: 1
    • description: A text description of the photo
      • Required: yes
      • Type: string
      • Example: Us looking mean in front of an abandoned warehouse
    • position: The sort position for this photo.
      • Required: no
      • Type: integer
      • Example: 1
    • small: A small non-retina artist photo

      • Required: yes
      • url: The URL to retrieve the photo
        • Required: yes
        • Type: string
        • Format: uri
        • Example: https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/preview_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png
    • small_hq: A retina preview artist photo

      • Required: yes
      • url: The URL to retrieve the photo
        • Required: yes
        • Type: string
        • Format: uri
        • Example: https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/previewretina673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png
    • medium: A medium sized artist photo

      • Required: yes
      • url: The URL to retrieve the photo
        • Required: yes
        • Type: string
        • Format: uri
        • Example: https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/smallwide673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png
    • medium_hq: A medium retina sized artist photo

      • Required: yes
      • url: The URL to retrieve the artist photo
        • Required: yes
        • Type: string
        • Format: uri
        • Example: https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/smallwideretina_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png
    • large: A large sized artist photo

      • Required: yes
      • url: The URL to retrieve the artist photo
        • Required: yes
        • Type: string
        • Format: uri
        • Example: https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/fullscreen_673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png
    • large_hq: A fullscreen retina artist photo

      • Required: yes
      • url: The URL to retrieve the artist photo
        • Required: yes
        • Type: string
        • Format: uri
        • Example: https://deliradio.s3.amazonaws.com/uploads/picture/band/2/1/fullscreenretina673e03ba-cc71-4f61-b7ee-f99faaf4ff3a.png

Response Codes

Successful Response Codes

  • 200: The artist photo was updated.

Failure Response Codes

  • 422: Indicates a bad request including validation errors.

  • 404: Indicates the account or photo was not found.

  • 401: Unauthorized request. Indicates a missing or invalid auth_token.