Skip to content

Post a comment

gerome12 edited this page Feb 20, 2019 · 7 revisions

Used to post a comment (private or public) about an album. For posting a comment, the user must be an admin or an user with "comments" permission.

URL : /albums/{album_id}/comments

Method : POST

Auth Required : Authorization with a JWT Bearer token with the user as the sub claim. The user must be am admin or an user with "comments" permission.

Headers

  • Accept : If present, require that this value be application/json

URL Parameters

  • comment={comment}
  • to_user={user} if set : the comment is private else, it's a public comment

Success Response

  • Status : 204 No Content

Error Response

If the calling user is not an admin or if he have not "comment" permission.

  • 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
Clone this wiki locally