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 Method
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/v66.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
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
Action