GET /api/conversations/:conversation_id/activities

get page of activities for a conversation

Params

Param name Description
conversation_id
optional

conversation to load the activities for


Value: Must be a Integer
page
optional

page of results to return


Value: Must be a Integer

Response Fields

activities array of activity results Array[Activity]
activity[id] unique id for this activity Integer
activity[verb] type of activity (post, update, join, leave) String
activity[title] descriptive sentence of the activity String
activity[actor[displayName]] full name of the activity actor String
activity[actor[firstName]] first name of the activity actor String
activity[actor[image][url]] image url for the activity actor String
activity[object[objectType]] data type of the activity (note, image, collection) String
activity[object[shared_message]] shared Message referenced by this activity. Contains all Message response fields except likes, comments, shared_message Hash
activity[object[replied_to_id]] id for the message or comment that this activity is in response to Integer
activity[object[replied_to_type]] the type of object that this activity is a reply to, valid values are "SocialObject" and "Comment" String
activity[object[replied_to_message_id]] id for either the message that this activity was a reply to or the parent message of the comment that this activity was a reply to Integer
activity[object[replied_to]] the object that this activity is a reply to. Contains all Message or Comment response fields except likes and message comments Hash
activity[object[client_provided_guid]] the client-provided unique identifier for the object, if any String
activity[published] timestamp when the activity was created DateTime
activity[location[longitude]] location longitude of the activity Integer
activity[location[latitude]] location latitude of the activity Integer
activity[generator[name]] name of client application that generated the activity String
activity[generator[url]] informational url of the client application that generated the activity String
activity[attachments] array of objects associated to this object (image, file) Array
activity[target] target of the activity (ex: Joe joined the *conversation*) Object

Example Curl Commands

curl -X GET -v --basic -u "emily@socialcast.com:demo" https://demo.socialcast.com/api/conversations/2/activities.json

Examples

GET /conversations/1/activities.json
200
{
  "activities": [
    {
      "id": 1,
      "verb": "post",
      "actor": {
        "id": 128,
        "displayName": "J'øhn115 D'øe113",
        "firstName": "J'øhn115",
        "image": {
          "height": 140,
          "width": 140,
          "url": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square140-7da7e1d98b33ef152280b1f653cfd80e2db24b01b625a72abc320673eea5af53.png",
          "is_system_default": true
        },
        "inactive": false,
        "terminated": false
      },
      "object": {
        "id": 1,
        "objectType": "note",
        "replied_to_id": 64,
        "replied_to_type": "SocialObject",
        "replied_to_message_id": 64,
        "replied_to": {
          "id": 64,
          "user": {
            "id": 130,
            "first_name": "J'øhn117",
            "last_name": "D'øe115",
            "name": "J'øhn117 D'øe115",
            "html_name": "J'øhn117 D'øe115",
            "url": "https://socialcast.socialcast.test/users/130-j%C3%B8hn117d%C3%B8e115",
            "avatars": {
              "is_system_default": true,
              "id": null,
              "square16": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square16-3b951350d61d203ece2fa5dd274fa7bd35275e132c17310d9006514f8839c857.png",
              "square30": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square30-6db66ac25c338d1e548a68465e2723ff63367c2aafbcc01db24c83964056b892.png",
              "square45": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square45-16865426333e244c59076d4f2475b711ed1ff9d12c97f4cf354f373a0170a1fd.png",
              "square70": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square70-1708999e8f1fea583408d7fc64b2177f853e4123bea2ffcf35f4839c8697e0ba.png",
              "square140": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square140-7da7e1d98b33ef152280b1f653cfd80e2db24b01b625a72abc320673eea5af53.png"
            },
            "username": "Jøhn117Døe115",
            "active": true,
            "terminated": false,
            "inactive": false,
            "role": "member",
            "type": "User",
            "title": null,
            "out_of_office": false,
            "out_of_office_on": null,
            "back_in_office_on": null,
            "company_login": null
          },
          "title": "",
          "body": "blørg & stuff 15",
          "html_body": "<div class=\"markdown-body\"><p>blørg &amp; stuff 15</p></div>",
          "action": "",
          "verb": null,
          "message_type": "status_message",
          "icon": null,
          "url": "https://socialcast.socialcast.test/api/messages/64",
          "permalink_url": "https://socialcast.socialcast.test/messages/64",
          "external_url": null,
          "created_at": "2017-09-21T20:30:53+00:00",
          "updated_at": "2017-09-21T20:30:53+00:00",
          "attachments": [],
          "media_files": [],
          "contains_url_only": null,
          "external_resources": [],
          "tags": [],
          "last_interacted_at": 1506025853,
          "group": {},
          "category_id": null,
          "recipients": [],
          "thumbnail_url": null,
          "player_url": null,
          "player_params": null,
          "likable": null,
          "ratable": false,
          "rating": null,
          "ratings_average": null,
          "ratings_count": null,
          "editable": null,
          "deletable": null,
          "watchable": false,
          "watch": null,
          "flag": null,
          "source": null,
          "poll": null,
          "embed": null,
          "hidden": null,
          "subscribed": null,
          "groups": [],
          "extensions": [],
          "new_group_id": null,
          "new_group_archived_at": null,
          "days_of_stickiness": 0,
          "sticky_for_current_user": false,
          "shareable": false,
          "share_count": 0,
          "client_provided_guid": null,
          "comments_count": 0,
          "comments": [],
          "likes": [],
          "likes_count": 0,
          "shared_message": null,
          "commentable": false
        },
        "client_provided_guid": null,
        "content": "testing & bläh & stuff 1",
        "html_body": "<div class=\"markdown-body\"><p>testing &amp; bläh &amp; stuff 1</p></div>",
        "shared_message": null
      },
      "title": "J'øhn115 D'øe113 sent a chat message",
      "published": "2017-09-21T13:30:54-07:00"
    }
  ]
}