Poll Notifications

GET

/api/notifications/poll

• DivinityEngine - Local development
• DivinityEngine - Localhost alternative

Poll for new notifications since a given timestamp.

Designed for frontend polling at ~15 s intervals. Returns only notifications newer than since (or all if omitted), filtered by min_priority.

Parameters

Query Parameters

since

Any of:

string

string

null

null

ISO timestamp — only return notifications newer than this

min_priority

Any of:

string

string

null

null

Minimum priority level (low, normal, high, critical)

Responses

200

Successful Response

PollNotificationsResponse

Response for the poll endpoint — only notifications newer than since.

object

notifications

required

Notifications

Array<object>

NotificationItem

Single notification in API responses.

object

id

required

Id

string

type

required

Type

string

Allowed values: success error warning info

priority

required

Priority

string

Allowed values: low normal high critical

source

required

Source

string

Allowed values: user system backend mime divine_agent service

category

required

Category

string

Allowed values: general agent mime system workflow project health error success

title

required

Title

string

message

required

Message

string

timestamp

required

Timestamp

string

duration

Any of:

integer

integer

null

null

groupKey

Any of:

string

string

null

null

progress

Any of:

integer

integer

null

null

metadata

Any of:

object

object

key

additional properties

any

null

null

serverTimestamp

Servertimestamp

string

422

Validation Error

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object