Remove a label from a photo. Requires admin access to the album.

POST /photo/removePhotoLabel
application/json

Body Required

  • albumId string Required

    The ID of the album containing the photo

  • photoId string Required

    The ID of the photo to remove the label from

  • label string Required

    The label to remove from the photo (max. 40 characters)

    Minimum length is 1, maximum length is 40.

  • isHidden boolean

    Whether or not the label is hidden from non-admin users. Defaults to false.

    Default value is false.

Responses

  • 200 application/json

    Label removed successfully

    Hide response attributes Show response attributes object
    • data object Required
      Hide data attribute Show data attribute object
      • message string Required
    • warnings array[string]
  • 400 application/json

    Invalid request. The request was malformed or missing required parameters.

    Hide response attribute Show response attribute object
    • message string Required
  • 404

    Album or photo not found

POST /photo/removePhotoLabel
curl \
 --request POST 'https://public-api.joinswsh.com/photo/removePhotoLabel' \
 --header "x-api-key: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"albumId":"22222222-2222-2222-2222-222222222222","photoId":"44444444-4444-4444-4444-444444444444","label":"Vacation","isHidden":false}'
Request examples
{
  "albumId": "22222222-2222-2222-2222-222222222222",
  "photoId": "44444444-4444-4444-4444-444444444444",
  "label": "Vacation",
  "isHidden": false
}
Response examples (200)
{
  "data": {
    "message": "Success!"
  },
  "warnings": [
    "Example warning"
  ]
}
Response examples (400)
{
  "message": "Invalid request"
}