Skip to main content

Feed & Comments

Team activity feed and discussion comments.

Activity Feed

GET /api/teams/{id}/feed

Get a team's activity feed, newest first.

Query Parameters:

ParameterTypeDefaultDescription
startinteger0Page index
sizeinteger10Items per page

Response:

A paginated HAL collection under _embedded["inf:feed-item"].

Get the team activity feedGET /api/teams/order-desk/feed?start=0&size=10
A paginated HAL collection of the team’s activity, newest first. Page with start (page index) and size.
Response · 200
{
"_links": {
"self": {
"href": "https://informer.example.com/api/teams/order-desk/feed?start=0&size=10"
}
},
"start": 0,
"count": 1,
"total": 1,
"_embedded": {
"inf:feed-item": [
{
"_links": {
"self": {
"href": "https://informer.example.com/api/teams/order-desk/feed/00000000-0000-4000-8000-000000000001"
}
},
"id": "00000000-0000-4000-8000-000000000001",
"sha": "2b27e9257de182b162db99f0ab3cc70626837c5c",
"actor": {
"username": "admin",
"displayName": "acme Administrator"
},
"verb": "userAddedToTeam",
"object": {
"username": "admin",
"displayName": "acme Administrator"
},
"target": {
"id": "order-desk",
"name": "Order Desk",
"permissions": {
"write": true,
"delete": true,
"reassign": true,
"addMember": true,
"addComment": true,
"removeMember": true,
"editMemberRole": true,
"assignOwnership": true
}
},
"createdAt": "2026-01-15T16:20:00.000Z",
"updatedAt": "2026-01-15T16:20:00.000Z",
"_altid": null,
"tenant": "acme"
}
]
}
}
Captured from the API examples test suite; ids and timestamps are normalized.

POST /api/teams/{id}/_markFeedViewed

Stamp the team's last-viewed time. Takes no request body, and marks the whole team feed viewed. Only an actual member can call this, even a superuser cannot mark a team feed they do not belong to.

Mark the team feed as viewedPOST /api/teams/order-desk/_markFeedViewed
Stamps the team’s last-viewed time. Only an actual member can call this, even a superuser cannot mark a team feed they do not belong to.
Response · 200
[
1
]
Captured from the API examples test suite; ids and timestamps are normalized.

Comments

GET /api/teams/{id}/comments

Get the team's top-level comments (no parent), newest first, each embedding its author and a replies link.

List team commentsGET /api/teams/order-desk/comments
Top-level comments (no parent) newest first, each embedding its author and a replies link.
Response · 200
{
"_links": {
"self": {
"href": "https://informer.example.com/api/teams/order-desk/comments?sort=-createdAt&limit=0"
}
},
"start": 0,
"count": 1,
"total": 1,
"_embedded": {
"inf:comment": [
{
"_links": {
"self": {
"href": "https://informer.example.com/api/comments/00000000-0000-4000-8000-000000000001"
},
"inf:comments": {
"href": "https://informer.example.com/api/comments/00000000-0000-4000-8000-000000000001/replies"
}
},
"permissions": {
"edit": true,
"delete": true
},
"id": "00000000-0000-4000-8000-000000000001",
"message": "Welcome to the Order Desk team!",
"public": false,
"userId": "admin",
"datasetId": null,
"datasourceId": null,
"reportId": null,
"queryId": null,
"teamId": "order-desk",
"jobId": null,
"templateId": null,
"assistantId": null,
"libraryId": null,
"mentions": null,
"createdAt": "2026-01-15T16:20:00.000Z",
"updatedAt": "2026-01-15T16:20:00.000Z",
"tenant": "acme",
"parentId": null,
"_embedded": {
"inf:user": {
"_links": {
"self": {
"href": "https://informer.example.com/api/users/admin"
},
"inf:memberships": {
"href": "https://informer.example.com/api/users/admin/memberships"
},
"inf:avatar-upload": {
"href": "https://informer.example.com/api/users/admin/_upload/{uploadId}/avatar-upload",
"templated": true
},
"inf:password": {
"href": "https://informer.example.com/api/users/admin/password"
},
"inf:feed": {
"href": "https://informer.example.com/api/users/admin/feed"
},
"inf:viewed-feed": {
"href": "https://informer.example.com/api/users/admin/_markFeedViewed"
},
"inf:superuser": {
"href": "https://informer.example.com/api/users/admin/superuser"
}
},
"permissions": {
"changeDomain": false,
"changeProfile": true,
"changePassword": true,
"delete": false,
"edit": true,
"reassign": true,
"superuser": true,
"enable": true,
"changeTheme": true,
"lock": true,
"setGlobalPermissions": true,
"manageLogin": true
},
"domain": "local",
"username": "admin",
"displayName": "acme Administrator",
"familyName": "Administrator",
"givenName": "acme",
"middleName": null,
"email": null,
"data": null,
"superuser": true,
"timezone": "America/New_York",
"settings": {
"log": {
"log": false,
"info": false,
"warn": false,
"debug": false,
"error": true,
"remote": false
}
},
"enabled": true,
"source": null,
"sourceId": null,
"lastViewedFeed": null,
"tenant": "acme",
"globalPermissions": {
"ai": false,
"jobCreation": true,
"viewAllTeams": true,
"viewAllUsers": true,
"painlessScriptCreation": true
},
"userFields": {},
"locked": false,
"lockedAt": null,
"loginAttempts": 0,
"passwordSetAt": "2026-01-15T16:20:00.000Z",
"passwordExpiresAt": "2026-01-15T16:20:00.000Z",
"forgotPasswordRequestTime": null,
"mfa": null,
"mfaConfig": {},
"aiMessage": null,
"aiConsent": false,
"hasSharedDatasources": false,
"createdAt": "2026-01-15T16:20:00.000Z",
"updatedAt": "2026-01-15T16:20:00.000Z",
"initials": "NA",
"colorIndex": 4,
"avatarColor": {
"background": "#81C784",
"text": "#1B5E20"
},
"managesPassword": true
}
}
}
]
}
}
Captured from the API examples test suite; ids and timestamps are normalized.

POST /api/teams/{id}/comments

Add a comment to the team.

Permissions: Team add-comment (member)

Request Body:

FieldTypeRequiredDescription
messagestringYesThe comment text
Add a team commentPOST /api/teams/order-desk/comments
Responds 201 with a Location header pointing at the new comment.
Request body
{
"message": "Welcome to the Order Desk team!"
}
Response · 201
{
"_links": {
"self": {
"href": "https://informer.example.com/api/comments/00000000-0000-4000-8000-000000000001"
}
},
"permissions": {
"edit": true,
"delete": true
},
"id": "00000000-0000-4000-8000-000000000001",
"public": false,
"tenant": "acme",
"message": "Welcome to the Order Desk team!",
"teamId": "order-desk",
"userId": "admin",
"updatedAt": "2026-01-15T16:20:00.000Z",
"createdAt": "2026-01-15T16:20:00.000Z",
"mentions": null,
"_altid": null,
"datasetId": null,
"datasourceId": null,
"reportId": null,
"queryId": null,
"jobId": null,
"parentId": null,
"templateId": null,
"assistantId": null,
"libraryId": null
}
Captured from the API examples test suite; ids and timestamps are normalized.