Skip to content
ShareOut ShareOut Docs

Activity feed (Needs You + Pulse)

GET
/v1/home/activity-feed
 
curl --request GET \
  --url 'https://shareout.site/v1/home/activity-feed?window=today&limit=30' \
  --header 'Authorization: Bearer <token>'

Two-surface feed for the signed-in home. Actionable events appear as individual rows; ambient events as aggregated Pulse counts. Filter by window (today, 7d, 30d) and optional workspace.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
workspace
string

Workspace id or slug; omit for Personal scope.

window
string
default: 7d
Allowed values: today 7d 30d
limit
integer
default: 30

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Activity feed payload

Media type application/json
object
needs

Actionable events — one row per event requiring action (excludes dismissed/opened items).

Array<object>
object
seen

Dismissed or opened Needs You events still within the selected window/limit — shown in the notifications panel Seen tab.

Array<object>
object
pulse

Aggregated ambient counts per kind over the selected window.

object
actionItems

Comments assigned to the signed-in user that are not yet resolved. Each item is a Comment with assigneeUserId, assigneeEmail, and optional dueAt set.

Array<object>
object
requestedOpen

Count of comments the signed-in user assigned to others that are still open (unresolved).

integer
Example generated
{
  "needs": [
    {}
  ],
  "seen": [
    {}
  ],
  "pulse": {},
  "actionItems": [
    {}
  ],
  "requestedOpen": 1
}