Activity

List agent notifications and publish activity

Alias of /api/v1/activity for Postiz-style notification consumers and agent workflows.

get/api/v1/notifications

Request

  • Base URL: https://www.poster.ly
  • URL: https://www.poster.ly/api/v1/notifications
  • Auth: HTTP bearer

Query parameters

workspace_idstring
post_idinteger
sincestring date-time
type'all' | 'activity' | 'publish'
limitinteger
offsetinteger

Events to skip; use next_offset from the previous page. offset + limit can be at most 1000; use since or post_id to look further back.

Response

Notifications fetched successfully

itemsobject[] required
totalinteger required

Items on this page (kept for older clients). Use has_more to tell whether more events exist.

limitinteger required
offsetinteger
has_moreboolean

True when more items exist after this page. Keep paging until it is false.

next_offsetinteger nullable

The offset of the next page, or null on the last page.

Example response

{
  "items": [
    {
      "id": "publish:123",
      "type": "publish",
      "post_id": 971,
      "platform": "instagram",
      "outcome": "success",
      "created_at": "2026-03-20T10:00:00.000Z"
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0,
  "has_more": false,
  "next_offset": null
}

Changes

No recorded changes to this operation across all 1 revision of this API.