Edit an album

Used to edit an album (only for an admin).

URL : /albums/{album_id}

Method : PATCH

Auth Required : Authorization with a JWT Bearer token with the user as the sub claim.

Headers

• Accept : If present, require that this value be application/json
• Content-Type : Must be application/x-www-form-urlencoded

Parameters

• name={name} (Optional)
• description={description} (Optional)
• addUser={true/false} (Optional)
• downloadSeries={true/false} (Optional)
• sendSeries={true/false} (Optional)
• deleteSeries={true/false} (Optional)
• addSeries={true/false} (Optional)
• writeComments={true/false} (Optional)
• notificationNewSeries={true/false} (Optional)
• notificationNewComment={true/false} (Optional)

Success Response

• Status : 200 OK

{
    "album_id": "37bs6GW5cR",
    "name": "album name",
    "description": "some description",
    "created_time": "2018-09-21T11:50:23",
    "last_event_time": "2018-09-21T11:50:23",
    "number_of_users": 1,
    "number_of_comments": 0,
    "number_of_studies": 0,
    "add_user": false,
    "download_series": true,
    "send_series": true,
    "delete_series": false,
    "add_series": true,
    "write_comments": true,
    "is_favorite": false,
    "notification_new_series": true,
    "notification_new_comment": true,
    "is_admin": true
}

Error Response

If the calling user is not an admin.

• Status : 403 Forbidden

If the user is not found.
If the album id does not exist.
If the user is not a member of the album.

• Status : 404 Not Found