Print this page

Summer '15 - New and Changed Chatter REST API Response Bodies

Knowledge Article Number 000214075
Description In Summer '15 release, these are some new and changed Chatter REST API response bodies as listed below.
Resolution

A) Action Links

Action Link Definition

This response body has one new property, label, which specifies a custom label to display on an action link button.

Action links have four statuses: NewStatus, PendingStatus, SuccessStatus, and FailedStatus. These strings are appended to the label for each status:

  • label
  • label Pending
  • label Success
  • label Failed

For example, if the value of label is “See Example,” the values of the four action link states are: See Example, See Example Pending, See Example Success, and See Example Failed.

An action link can use either label or labelKey to generate label names, it can’t use both. If label has a value, the value oflabelKey is None. If labelKey has a value other than None, the value of label is null.

B) Communities

User Settings

This response body has one new property, canViewCommunitySwitcher, that specifies whether the user can see the community switcher menu.

C) Feeds

Comment Capabilities

This response body has this new property:

  • edit—If a comment has this capability, users who have permission can edit it.

Edit Capability

This new response body has these properties:

  • isEditRestricted—Specifies whether editing this feed element or comment is restricted. If true, the context user can’t edit this feed element or comment. If false, the context user may or may not have permission to edit this feed element or comment. To determine if the context user can edit a feed element or comment, use the Feed Elements, Editability or the Comment Capability, Editability resource.
  • isEditableByMeUrl—The URL to check if the context user is able to edit this feed element or comment.
  • lastEditedBy—Who last edited this feed element or comment.
  • lastEditedDate—The most recent edit date of this feed element or comment.
  • latestRevision—The most recent revision of this feed element or comment.
  • relativeLastEditedDate—Relative last edited date, for example, “2h ago.”

Feed Element Capabilities

This response body has this new property:

  • edit—If a feed element has this capability, users who have permission can edit it.

Feed Entity Is Editable

This new response body has these properties:

  • feedEntityUrl—URL of the feed element or comment.
  • isEditableByMetrue if the context user can edit the feed element or comment, false otherwise.

D) Files

User Settings

This response body has one new property, hasFileSyncManagedClientAutoUpdate, that indicates whether the administrator for the user’s organization allows file sync clients to update automatically.

E) Motif

Motif

This response body has a new svgIconUrl property, which is the URL to an icon in SVG format that represents a record type.

Recommendations

Non-Entity Recommendation

This response body is no longer used in version 34.0 and later. In version 34.0 and later, the Recommendation response body is used for all recommendations.

Recommendation

The entity property can now contain a Recommended Object response body, which represents a custom recommendation.

In addition, the Recommendation response body has these new properties:

  • platformActionGroup—A platform action group instance with state appropriate for the context user.
  • url—URL for the recommendation.

Recommendation Definition

This response body has one new property, actionUrlName, that is the text label to the action URL in the user interface.

Recommendations Capability

The items property of this response body no longer includes Non-Entity Recommendations. In version 34.0 and later, the Recommendation response body is used for all recommendations.

Recommended Object

This new response body represents custom recommendations and has these properties:

  • idOrEnum—ID of a recommendation definition for a custom recommendation.
  • motif—Motif of the recommended object.
  • name—Name of the recommended object.
  • typeRecommendedObject

Scheduled Recommendation

This response body has one new property, enabled, that indicates whether the recommendation is scheduled.





promote demote