Skip to content

Activity Stream

Use this endpoint when an external system needs to read channel activity items, optionally filtered to a specific object inside the channel.

Returns the activity stream on a channel with optional object filter.

Required Scope

activity_read

Parameters

Parameter Name Description
apiKey A unique key used to authenticate and authorise the calling system.
logonId User’s logon Id.
logonProvider The authentication provider used for user login (e.g., 'Organization' for Emakin's default login system).
channelId Id number of channel. Required.
date Start date of activities. If not specified all returns.
order Order of activities. Can be Ascending (default) or Descending.
length Maximum number of activities to return. If not specified all returns.
objectId Object Id to filter activities. If not specified all returns.

Example Call

1
2
3
4
5
6
7
8
POST https://mydomain.emakin.com/rest/v1/activitystream

{
     "apiKey": "xxxx",
     "logonId": "[email protected]",
     "logonProvider": "Organization",
     "channelId" : "ABC...DEF",
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[
  {
    "selectedAction": "Done",
    "content": null,
    "href": "/app/?/workitem/ec30f70c-02dc-4525-9bbe-ff7a3d40b9c1",
    "task": "Check Weekly Leave Requests",
    "actor": null,
    "@id": "1c54d45f-7e7a-421b-b3a5-6f8f5a17161b",
    "@type": "complete",
    "actorId": null,
    "objectId": "ec30f70c-02dc-4525-9bbe-ff7a3d40b9c1",
    "objectType": "workitem",
    "published": "2020-04-06T13:25:50.889205+03:00",
    "updated": null,
    "targets": [
      {
        "targetId": "67225e6d-52ac-4b46-8909-8e6d22894a7e",
        "name": "Actors",
        "@type": "Actors"
      }
    ]
  },
  {
    "task": "Check Weekly Leave Requests",
    "workItem": "ee19ff32-7001-475b-96c2-28b6cac49b60",
    "href": "/app/?/workitem/ee19ff32-7001-475b-96c2-28b6cac49b60",
    "actor": null,
    "@id": "76b60513-9d4b-4426-98b5-6d41b4d242a4",
    "@type": "create",
    "actorId": null,
    "objectId": "69059a22-2316-42e5-89c0-c0dc53c493d1",
    "objectType": "instance",
    "published": "2020-04-13T00:13:18.904294+03:00",
    "updated": null,
    "targets": [
      {
        "targetId": "76b60513-9d4b-4426-98b5-6d41b4d242a4",
        "name": "Actors",
        "@type": "Actors"
      }
    ]
  }
]