Group Banner Photo

To use an image from the Files page as a group banner photo, pass the file ID in the fileId property of the request body or in the fileId request parameter. Images uploaded on the Group page don’t have a file ID and can’t be used as the fileId.

To upload a binary file as the group banner photo, send it in a multipart/form-data message. For information about how to create the multipart/form-data message, see Uploading Binary Files.

Resource

1/chatter/groups/groupId/banner-photo

1/connect/communities/communityId/chatter/groups/groupId/banner-photo

Available version

36.0

Requires Chatter

Yes

HTTP methods

GET, HEAD, DELETE, POST

Group owners and managers and users with the “Manage All Data” permission can DELETE and POST group banner photos.

Request body for POST

Root XML tag

<bannerPhoto>

JSON example

1{   "cropHeight" : "120",
2    "cropWidth" : "240",
3    "fileId" : "069D00000001IOh"
4}

Properties

Name	Type	Description	Required or Optional	Available Version
cropHeight	Integer	Height of the crop rectangle in pixels.	Optional	36.0
cropWidth	Integer	Width of the crop rectangle in pixels.	Optional	36.0
cropX	Integer	X position of the crop rectangle from the left edge of the image in pixels. Top left is position (0,0).	Optional	36.0
cropY	Integer	Y position of the crop rectangle from the top edge of the image in pixels. Top left is position (0,0).	Optional	36.0
fileId	String	ID of an existing file. The key prefix must be 069, and the file size must be less than 8 MB. Images uploaded on the Group page and on the User page don’t have file IDs and therefore can’t be used. Note	Required to use an existing file	36.0
versionNumber	Integer	Version number of an existing file. If not provided, the latest version is used.	Optional	36.0

Request parameters for POST

Name	Type	Description	Required or Optional	Available Version
cropHeight	Integer	The length of an edge in pixels of the crop rectangle.	Optional	36.0
cropWidth	Integer	The width of an edge in pixels of the crop rectangle.	Optional	36.0
cropX	Integer	The position X in pixels from the left edge of the image to start the crop square. Top left is position (0,0).	Optional	36.0
cropY	Integer	The position Y in pixels from the top edge of the image to start the crop square. Top left is position (0,0).	Optional	36.0
fileId	String	ID of an existing file. The key prefix must be 069 and the file size must be less than 8 MB. Images uploaded on the Group page and on the User page don’t have file IDs and therefore can’t be used. Note	Required to use an existing file	36.0
versionNumber	Integer	Version number of an existing file. If not provided, the latest version is used.	Optional	36.0

Photos are processed asynchronously and may not be visible right away.

Note

Response body for GET and POST

Banner Photo

Response body for DELETE

204: Successful Delete