Skip Navigation

Newer Version Available

This content describes an older version of this product. View Latest

Action Link Definition

The definition of an action link. To read this information, a request must use the same connected app that was used to create the action link definition.

Property Name	Type	Description	Filter Group and Version	Available Version
`actionUrl`	String	The action link URL. For example, for a `Ui` action link, the URL may be a Web page. For a `Download` action link, the URL is a link to the file to download. `Ui` and `Download` action link URLs are provided to clients. For an `Api` or `ApiAsync` action link, the URL may be a REST resource. `Api` and `ApiAsync` action link URLs aren’t provided to clients. Links to Salesforce can be relative. All other links must be absolute and start with `https://`.	Small, 33.0	33.0
`createdDate`	Date	An ISO 8601 format date string, for example, 2011-02-25T18:24:31.000Z..	Small, 33.0	33.0
`excludedUserId`	String	ID of a single user to exclude from performing the action. If you specify an `excludedUserId`, you can’t specify a `userId`.	Small, 33.0	33.0
`groupDefault`	Boolean	`true` if this action is the default action link in the action link group; `false` otherwise. There can be only one default action link per action link group. The default action link gets distinct styling in the Salesforce UI.	Small, 33.0	33.0
`headers`	Request Header[]	The request headers for the `Api` and `ApiAsync` action link types.	Big, 33.0	33.0
`id`	String	18-character ID for the action link definition.	Small, 33.0	33.0
`labelKey`	String	Key for the set of labels to show in the user interface. A set includes labels for these states: new, pending, success, failed. For example, if you use the `Approve` key, you get these labels: Approve, Pending, Approved, Failed. See Action Links Labels.	Small, 33.0	33.0
`method`	String	The HTTP method. One of these values: `HttpDelete`—Returns HTTP 204 on success. Response body or output class is empty. `HttpGet`—Returns HTTP 200 on success. `HttpHead`—Returns HTTP 200 on success. Response body or output class is empty. `HttpPatch`—Returns HTTP 200 on success or HTTP 204 if the response body or output class is empty. `HttpPost`—Returns HTTP 201 on success or HTTP 204 if the response body or output class is empty. Exceptions are the batch posting resources and methods, which return HTTP 200 on success. `HttpPut`—Return HTTP 200 on success or HTTP 204 if the response body or output class is empty.	Medium, 33.0	33.0
`modifiedDate`	Date	ISO8601 date string, for example, 2011-02-25T18:24:31.000Z.	Small, 33.0	33.0
`requestBody`	String	The request body for `Api` and `ApiAsync` action link types.	Big, 33.0	33.0
`requiresConfirmation`	Boolean	`true` if the action results in something that should be confirmed, such as a delete; `false` otherwise.	Small, 33.0	33.0
`templateId`	String	The ID of the action link template from which to instantiate this action link, or `null` if the action link isn’t associated with a template.	Medium, 33.0	33.0
`type`	String	Defines the type of action link. Values are: `Api`—The action link calls a synchronous API at the action URL. Salesforce sets the status to `SuccessfulStatus` or `FailedStatus` based on the HTTP status code returned by your server. `ApiAsync`—The action link calls an asynchronous API at the action URL. The action remains in a `PendingStatus` state until a a third-party makes a request to `/connect/action-links/actionLinkId` to set the status to `SuccessfulStatus` or `FailedStatus` when the asynchronous operation is complete. `Download`—The action link downloads a file from the action URL. `Ui`—The action link takes the user to a Web page at the action URL.	Small, 33.0	33.0
`userId`	String	The ID of the user who can execute the action. If not specified or `null`, any user can execute the action. If you specify a `userId`, you can’t specify an `excludedUserId`.	Small, 33.0	33.0