Salesforce Feed API

The Feed API from Salesforce — 7 operation(s) for feed.

Documentation

Specifications

Schemas & Data

OpenAPI Specification

salesforce-feed-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Salesforce Bulk API 2.0 Abort Feed API
  description: 'Salesforce Bulk API 2.0 is a simplified, REST-based interface for bulk data operations that improves on the original Bulk API. It uses a straightforward job model and supports CSV format for ingest and query jobs, enabling processing of millions of records asynchronously.

    '
  version: v63.0
  contact:
    name: Salesforce Developers
    url: https://developer.salesforce.com/
  license:
    name: Salesforce Developer Terms
    url: https://www.salesforce.com/company/legal/agreements/
servers:
- url: https://{instance}.salesforce.com/services/data/v{version}/jobs
  description: Salesforce Bulk API 2.0 jobs endpoint
  variables:
    instance:
      default: yourInstance
      description: 'The Salesforce instance identifier (e.g., na1, eu3, or a My Domain subdomain like mycompany).

        '
    version:
      default: '63.0'
      description: 'The Salesforce API version number (e.g., 63.0). Use the latest supported version for new integrations.

        '
security:
- BearerAuth: []
tags:
- name: Feed
paths:
  /data/v64.0/chatter/feeds/news/me/feed-elements:
    parameters: []
    get:
      tags:
      - Feed
      summary: Salesforce News Feed Elements
      description: 'All feed elements from all groups the context user either owns or is a member of, as well as all files, records, and users the context user follows. Use this resource to get information about feed elements and to post feed elements.


        For information about posting a feed element, see Feed Elements, Post and Search.


        https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resource_feeds_news.htm#cc_news_feed_elements'
      operationId: NewsFeedElements
      parameters: []
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Wed, 22 Nov 2023 11:04:02 GMT
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=63072000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-XSS-Protection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 1; mode=block
            X-Robots-Tag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-cache,must-revalidate,max-age=0,no-store,private
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Accept-Encoding
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: gzip
            Transfer-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: chunked
          content:
            application/json;charset=UTF-8:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessfulNewsFeedElements'
                - examples:
                  - currentPageToken: null
                    currentPageUrl: /services/data/v58.0/chatter/feeds/news/005.../feed-elements
                    elements: []
                    isModifiedToken: null
                    isModifiedUrl: null
                    nextPageToken: null
                    nextPageUrl: null
                    updatesToken: 2:1700651042000
                    updatesUrl: /services/data/v58.0/chatter/feeds/news/005.../feed-elements?updatedSince=2%3A1700651042000
                contentMediaType: application/json;charset=UTF-8
              example:
                currentPageToken: null
                currentPageUrl: /services/data/v58.0/chatter/feeds/news/005.../feed-elements
                elements: []
                isModifiedToken: null
                isModifiedUrl: null
                nextPageToken: null
                nextPageUrl: null
                updatesToken: 2:1700651042000
                updatesUrl: /services/data/v58.0/chatter/feeds/news/005.../feed-elements?updatedSince=2%3A1700651042000
      deprecated: false
      servers:
      - url: https://services
        variables: {}
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /data/v64.0/chatter/feeds/user-profile/{USER_ID}/feed-elements:
    parameters: []
    get:
      tags:
      - Feed
      summary: Salesforce User Profile Feed Elements
      description: 'Returns feed elements created when a user changes records that can be tracked in a feed, feed elements whose parent is the user, and feed elements that mention the user. This feed is different than the news feed, which returns more feed items, including group updates. You can post feed items to the user-profile feed. You can get another user’s user profile feed.


        https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resource_feeds_user_profile.htm'
      operationId: UserProfileFeedElements
      parameters:
      - name: USER_ID
        in: path
        description: ''
        required: true
        schema:
          type: string
        example: '500123'
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Wed, 22 Nov 2023 11:04:39 GMT
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=63072000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-XSS-Protection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 1; mode=block
            X-Robots-Tag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-cache,must-revalidate,max-age=0,no-store,private
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Accept-Encoding
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: gzip
            Transfer-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: chunked
          content:
            application/json;charset=UTF-8:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessfulUserProfileFeedElements'
                - examples:
                  - currentPageToken: null
                    currentPageUrl: /services/data/v58.0/chatter/feeds/user-profile/005.../feed-elements
                    elements: []
                    isModifiedToken: null
                    isModifiedUrl: null
                    nextPageToken: null
                    nextPageUrl: null
                    updatesToken: null
                    updatesUrl: null
                contentMediaType: application/json;charset=UTF-8
              example:
                currentPageToken: null
                currentPageUrl: /services/data/v58.0/chatter/feeds/user-profile/005.../feed-elements
                elements: []
                isModifiedToken: null
                isModifiedUrl: null
                nextPageToken: null
                nextPageUrl: null
                updatesToken: null
                updatesUrl: null
      deprecated: false
      servers:
      - url: https://services
        variables: {}
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /data/v64.0/chatter/feeds/record/{RECORD_GROUP_ID}/feed-elements:
    parameters: []
    get:
      tags:
      - Feed
      summary: Salesforce Record Feed Elements
      description: 'Returns the feed elements for all the records the context user is following, or all the feed elements of the specified recordId. Use this resource to search a feed or to get the feed elements for a specific feed, including another user’s feed. To use this resource to get the feed elements for a group, specify the group ID as the recordId.


        https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resource_feeds_record.htm'
      operationId: RecordFeedElements
      parameters:
      - name: RECORD_GROUP_ID
        in: path
        description: ''
        required: true
        schema:
          type: string
        example: '500123'
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Wed, 22 Nov 2023 11:05:44 GMT
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=63072000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-XSS-Protection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 1; mode=block
            X-Robots-Tag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-cache,must-revalidate,max-age=0,no-store,private
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Accept-Encoding
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: gzip
            Transfer-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: chunked
          content:
            application/json;charset=UTF-8:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessfulRecordFeedElements'
                - examples:
                  - currentPageToken: null
                    currentPageUrl: /services/data/v58.0/chatter/feeds/record/001.../feed-elements
                    elements: []
                    isModifiedToken: null
                    isModifiedUrl: null
                    nextPageToken: null
                    nextPageUrl: null
                    updatesToken: 2:1700651144000
                    updatesUrl: /services/data/v58.0/chatter/feeds/record/001.../feed-elements?updatedSince=2%3A1700651144000
                contentMediaType: application/json;charset=UTF-8
              example:
                currentPageToken: null
                currentPageUrl: /services/data/v58.0/chatter/feeds/record/001.../feed-elements
                elements: []
                isModifiedToken: null
                isModifiedUrl: null
                nextPageToken: null
                nextPageUrl: null
                updatesToken: 2:1700651144000
                updatesUrl: /services/data/v58.0/chatter/feeds/record/001.../feed-elements?updatedSince=2%3A1700651144000
      deprecated: false
      servers:
      - url: https://services
        variables: {}
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /data/v64.0/chatter/feed-elements:
    parameters: []
    post:
      tags:
      - Feed
      summary: Salesforce Feed Elements, Post and Search
      description: 'Feed item and comment bodies have a 10,000 character limit. Because this limit can change, we recommend that clients make a describeSObjects() call on the FeedItem or FeedComment object. To determine the maximum number of allowed characters, look at the length of the Body or CommentBody field.


        https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_feed_element.htm'
      operationId: FeedElements,PostandSearch
      parameters:
      - name: feedElementType
        in: query
        description: 'Feed elements are the top-level objects that a feed contains. The feed element type describes the characteristics of that feed element. One of these values:

          Bundle—A container of feed elements. A bundle also has a body made up of message segments that can always be gracefully degraded to text-only values.

          FeedItem—A feed item has a single parent and is scoped to one community or across all communities. A feed item can have capabilities such as bookmarks, canvas, content, comment, link, poll. Feed items have a body made up of message segments that can always be gracefully degraded to text-only values.

          Recommendation—A recommendation is a feed element with a recommendations capability. A recommendation suggests records to follow, groups to join, or applications that are helpful to the context user.'
        required: true
        style: form
        explode: true
        schema:
          type: string
          examples:
          - FeedItem
        example: example_value
      - name: subjectId
        in: query
        description: ''
        required: true
        style: form
        explode: true
        schema:
          type: string
          examples:
          - <USER_GROUP_RECORD_ID>
        example: '500123'
      - name: text
        in: query
        description: ''
        required: true
        style: form
        explode: true
        schema:
          type: string
          examples:
          - New Feed Item
        example: example_value
      responses:
        '201':
          description: Created
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Wed, 22 Nov 2023 11:06:07 GMT
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=63072000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-XSS-Protection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 1; mode=block
            X-Robots-Tag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-cache,must-revalidate,max-age=0,no-store,private
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Accept-Encoding
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: gzip
            Transfer-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: chunked
          content:
            application/json;charset=UTF-8:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessfulFeedElementsPostandSearch'
                - examples:
                  - actor:
                      additionalLabel: null
                      communityNickname: User1696423780773910041
                      companyName: Salesforce
                      displayName: Name
                      firstName: Firstname
                      id: 005...
                      isActive: true
                      isInThisCommunity: true
                      lastName: Name
                      motif:
                        color: 1B96FF
                        largeIconUrl: /img/icon/profile64.png
                        mediumIconUrl: /img/icon/profile32.png
                        smallIconUrl: /img/icon/profile16.png
                        svgIconUrl: null
                      mySubscription: null
                      name: Name
                      outOfOffice:
                        message: ''
                      photo:
                        fullEmailPhotoUrl: https://<my_domain>/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0IogXzXAXaYKJnuWCNQmXymRq?fromEmail=1
                        largePhotoUrl: https://<my_domain>/profilephoto/729.../F
                        mediumPhotoUrl: https://<my_domain>/profilephoto/729.../M
                        photoVersionId: 729...
                        smallPhotoUrl: https://<my_domain>/profilephoto/729.../T
                        standardEmailPhotoUrl: https://<my_domain>/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0Ioi-dtynkoFWsl46as__TDFU?fromEmail=1
                        url: /services/data/v58.0/connect/user-profiles/005.../photo
                      reputation: null
                      title: null
                      type: User
                      url: /services/data/v58.0/chatter/users/005...
                      userType: Internal
                    body:
                      isRichText: false
                      messageSegments:
                      - text: New Feed Item
                        type: Text
                      text: New Feed Item
                    capabilities:
                      associatedActions:
                        platformActionGroups: []
                      bookmarks:
                        isBookmarkedByCurrentUser: false
                      chatterLikes:
                        isLikedByCurrentUser: false
                        likesMessage: null
                        myLike: null
                        page:
                          currentPageToken: 0
                          currentPageUrl: /services/data/v58.0/chatter/feed-elements/0D5.../capabilities/chatter-likes/items
                          items: []
                          nextPageToken: null
                          nextPageUrl: null
                          previousPageToken: null
                          previousPageUrl: null
                          total: 0
                      close:
                        canContextUserUpdateIsClosed: true
                        isClosed: false
                      comments:
                        page:
                          currentPageToken: null
                          currentPageUrl: /services/data/v58.0/chatter/feed-elements/0D5.../capabilities/comments/items
                          items: []
                          nextPageToken: null
                          nextPageUrl: null
                          previousPageToken: null
                          previousPageUrl: null
                          total: 0
                      edit:
                        isEditRestricted: false
                        isEditableByMeUrl: /services/data/v58.0/chatter/feed-elements/0D5.../capabilities/edit/is-editable-by-me
                        lastEditedBy: null
                        lastEditedDate: null
                        latestRevision: 1
                        relativeLastEditedDate: null
                      interactions:
                        count: 0
                      mute:
                        isMutedByMe: false
                      readBy:
                        isReadByMe: true
                        lastReadDateByMe: '2023-11-22T11:06:07.000Z'
                        page:
                          currentPageToken: null
                          currentPageUrl: /services/data/v58.0/chatter/feed-elements/0D5.../capabilities/read-by/items?pageSize=3
                          items: []
                          nextPageToken: null
                          nextPageUrl: null
                          previousPageToken: null
                          previousPageUrl: null
                          total: 0
                      status:
                        feedEntityStatus: Published
                        isApprovableByMe: true
                      topics:
                        canAssignTopics: true
                        items: []
                      upDownVote:
                        downVoteCount: 0
                        myVote: None
                        upVoteCount: 0
                    clientInfo:
                      applicationName: Postman Playground
                      applicationUrl: null
                    createdDate: '2023-11-22T11:06:07.000Z'
                    event: false
                    feedElementType: FeedItem
                    hasVerifiedComment: false
                    header:
                      isRichText: null
                      messageSegments:
                      - motif:
                          color: 1B96FF
                          largeIconUrl: /img/icon/profile64.png
                          mediumIconUrl: /img/icon/profile32.png
                          smallIconUrl: /img/icon/profile16.png
                          svgIconUrl: null
                        reference:
                          id: 005...
                          url: /services/data/v58.0/chatter/users/005...
                        text: Name
                        type: EntityLink
                      text: Name
                    id: 0D5...
                    isDeleteRestricted: false
                    isSharable: false
                    modifiedDate: '2023-11-22T11:06:07.000Z'
                    originalFeedItem: null
                    originalFeedItemActor: null
                    parent:
                      entityLabel:
                        label: Account
                        labelPlural: Accounts
                      id: 001...
                      motif:
                        color: 5867E8
                        largeIconUrl: /img/icon/accounts64.png
                        mediumIconUrl: /img/icon/accounts32.png
                        smallIconUrl: /img/icon/accounts16.png
                        svgIconUrl: null
                      mySubscription: null
                      name: Burlington Textiles Corp of America
                      type: Account
                      url: /services/data/v58.0/chatter/records/001...
                    photoUrl: https://<my_domain>/profilephoto/729.../T
                    relativeCreatedDate: Just now
                    type: TextPost
                    url: /services/data/v58.0/chatter/feed-elements/0D5...
                    visibility: InternalUsers
                contentMediaType: application/json;charset=UTF-8
              example:
                actor:
                  additionalLabel: null
                  communityNickname: User1696423780773910041
                  companyName: Salesforce
                  displayName: Name
                  firstName: Firstname
                  id: 005...
                  isActive: true
                  isInThisCommunity: true
                  lastName: Name
                  motif:
                    color: 1B96FF
                    largeIconUrl: /img/icon/profile64.png
                    mediumIconUrl: /img/icon/profile32.png
                    smallIconUrl: /img/icon/profile16.png
                    svgIconUrl: null
                  mySubscription: null
                  name: Name
                  outOfOffice:
                    message: ''
                  photo:
                    fullEmailPhotoUrl: https://<my_domain>/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0IogXzXAXaYKJnuWCNQmXymRq?fromEmail=1
                    largePhotoUrl: https://<my_domain>/profilephoto/729.../F
                    mediumPhotoUrl: https://<my_domain>/profilephoto/729.../M
                    photoVersionId: 729...
                    smallPhotoUrl: https://<my_domain>/profilephoto/729.../T
                    standardEmailPhotoUrl: https://<my_domain>/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0Ioi-dtynkoFWsl46as__TDFU?fromEmail=1
                    url: /services/data/v58.0/connect/user-profiles/005.../photo
                  reputation: null
                  title: null
                  type: User
                  url: /services/data/v58.0/chatter/users/005...
                  userType: Internal
                body:
                  isRichText: false
                  messageSegments:
                  - text: New Feed Item
                    type: Text
                  text: New Feed Item
                capabilities:
                  associatedActions:
                    platformActionGroups: []
                  bookmarks:
                    isBookmarkedByCurrentUser: false
                  chatterLikes:
                    isLikedByCurrentUser: false
                    likesMessage: null
                    myLike: null
                    page:
                      currentPageToken: 0
                      currentPageUrl: /services/data/v58.0/chatter/feed-elements/0D5.../capabilities/chatter-likes/items
                      items: []
                      nextPageToken: null
                      nextPageUrl: null
                      previousPageToken: null
                      previousPageUrl: null
                      total: 0
                  close:
                    canContextUserUpdateIsClosed: true
                    isClosed: false
                  comments:
                    page:
                      currentPageToken: null
                      currentPageUrl: /services/data/v58.0/chatter/feed-elements/0D5.../capabilities/comments/items
                      items: []
                      nextPageToken: null
                      nextPageUrl: null
                      previousPageToken: null
                      previousPageUrl: null
                      total: 0
                  edit:
                    isEditRestricted: false
                    isEditableByMeUrl: /services/data/v58.0/chatter/feed-elements/0D5.../capabilities/edit/is-editable-by-me
                    lastEditedBy: null
                    lastEditedDate: null
                    latestRevision: 1
                    relativeLastEditedDate: null
                  interactions:
                    count: 0
                  mute:
                    isMutedByMe: false
                  readBy:
                    isReadByMe: true
                    lastReadDateByMe: '2023-11-22T11:06:07.000Z'
                    page:
                      currentPageToken: null
                      currentPageUrl: /services/data/v58.0/chatter/feed-elements/0D5.../capabilities/read-by/items?pageSize=3
                      items: []
                      nextPageToken: null
                      nextPageUrl: null
                      previousPageToken: null
                      previousPageUrl: null
                      total: 0
                  status:
                    feedEntityStatus: Published
                    isApprovableByMe: true
                  topics:
                    canAssignTopics: true
                    items: []
                  upDownVote:
                    downVoteCount: 0
                    myVote: None
                    upVoteCount: 0
                clientInfo:
                  applicationName: Postman Playground
                  applicationUrl: null
                createdDate: '2023-11-22T11:06:07.000Z'
                event: false
                feedElementType: FeedItem
                hasVerifiedComment: false
                header:
                  isRichText: null
                  messageSegments:
                  - motif:
                      color: 1B96FF
                      largeIconUrl: /img/icon/profile64.png
                      mediumIconUrl: /img/icon/profile32.png
                      smallIconUrl: /img/icon/profile16.png
                      svgIconUrl: null
                    reference:
                      id: 005...
                      url: /services/data/v58.0/chatter/users/005...
                    text: Name
                    type: EntityLink
                  text: Name
                id: 0D5...
                isDeleteRestricted: false
                isSharable: false
                modifiedDate: '2023-11-22T11:06:07.000Z'
                originalFeedItem: null
                originalFeedItemActor: null
                parent:
                  entityLabel:
                    label: Account
                    labelPlural: Accounts
                  id: 001...
                  motif:
                    color: 5867E8
                    largeIconUrl: /img/icon/accounts64.png
                    mediumIconUrl: /img/icon/accounts32.png
                    smallIconUrl: /img/icon/accounts16.png
                    svgIconUrl: null
                  mySubscription: null
                  name: Burlington Textile

# --- truncated at 32 KB (168 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/salesforce/refs/heads/main/openapi/salesforce-feed-api-openapi.yml