Get Photo Actions

Get the photo actions for pages. Currently, only group and user pages support photo actions.

Resource

1/ui-api/actions/photo/${recordIds}

recordIds—A single record ID, or a comma-delimited list of record IDs.

Available version

41.0

HTTP methods

GET

Example

As an example, let’s say we have a Group tab with a record ID of 0F9R00000000182KAA . To get information about the photo actions on the tab, make this request:

1GET /services/data/v41.0/ui-api/actions/photo/0F9R00000000182KAA

The request returns a list of photo actions on the tab and the URLs of the request and subrequests.

1{
2  "actions" : {
3    "0F9R00000000182KAA" : {
4      "actions" : [ {
5        "actionListContext" : "Photo",
6        "actionTarget" : null,
7        "actionTargetType" : "Invoke",
8        "apiName" : "ViewPhotoAction",
9        "externalId" : "00DR00000008n7M:0F9R00000000182KAA::Photo:Phone:StandardButton:ViewPhotoAction",
10        "iconUrl" : "https://yourInstance.salesforce.com/img/icon/t4v35/action/email_120.png",
11        "id" : "0JVR00000000035OAA",
12        "isMassAction" : "false",
13        "label" : "View Photo",
14        "primaryColor" : "95AEC5",
15        "relatedListRecordId" : null,
16        "relatedSourceObject" : null,
17        "section" : "Page",
18        "sourceObject" : "0F9R00000000182KAA",
19        "subtype" : null,
20        "targetObject" : null,
21        "targetUrl" : null,
22        "type" : "StandardButton"
23      }
24
25... Additional actions removed for brevity ...
26
27],
28      "links" : [ ],
29      "url" : "/services/data/v41.0/ui-api/actions/photo/0F9R00000000182KAA"
30    }
31  },
32  "url" : "/services/data/v41.0/ui-api/actions/photo/0F9R00000000182KAA"
33}

Request parameters for GET

Parameter Name	Type	Description	Required or Optional	Available Version
`actionTypes`	String[]	The action type. One or more of these values: `CustomButton`—A button that opens a URL or Visualforce page or executes JavaScript. `ProductivityAction`—A pre-defined Salesforce action, attached to a limited set of objects. `QuickAction`—A global or object-specific action. `StandardButton`—A pre-defined Salesforce button, such as New, Edit, and Delete.	Optional	41.0
`apiNames`	String[]	The API names of one or more actions to be retrieved. Use this parameter only when passing `retrievalMode=All`.	Optional	49.0
`formFactor`	String	The layout display size. One of these values: `Large`—(Default) Use this value to get a layout for desktop display size. `Medium`—Use this value to get a layout for tablet display size. `Small`—Use this value to get a layout for phone display size.	Optional	41.0
`retrievalMode`	String	When the action context is `Record`, this parameter indicates which actions to retrieve from the record page. One of these values: `All`—Retrieves all actions specified in the `apiNames` parameter. `PageLayout`—(Default) Retrieves actions from the page layout.	Optional	49.0
`sections`	String[]	The section of the user interface that the actions reside in. One or more of these values: `ActivityComposer` `CollaborateComposer` `Page` `SingleActionLinks`	Optional	41.0

Response body for GET

ActionRepresentation

User Interface API Developer Guide

Get Photo Actions