POST ​/api​/v3​/account​/:id​/artist_profile​/photo

Add an artist photo for this account.

Request

Example Request

{
  "auth_token": "abc1245920feab98ca",
  "photo": {
    "description": "Us looking mean in front of an abandoned warehouse",
    "position": 1,
    "remote_photo_url": "http://example.com/band.png",
    "file": null
  }
}

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 add.

    • 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
    • remotephotourl: URL to an image. Ignored if file parameter is also passed.
      • Required: no
      • Type:
        • null
        • string
      • Example: http://example.com/band.png
    • file: Image file bytes. Takes precedence if remotephotourl parameter is also passed.
      • Required: no
      • Type:
        • null
        • file

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

  • 201: The artist photo was created.

Failure Response Codes

  • 422: Indicates a bad request including validation errors.

  • 404: Indicates the account was not found.

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