Notifications

Notifications are automatically created by the AI pipeline when a fill job changes state - for example, when it transitions from processing toready or failed. Use these REST endpoints to poll for events, display badge counters, and manage read state.

2 endpointsBearer sk_live_xxxBase: /v1/sdk/notifications

AuthAuthorization: Bearer sk_live_xxxxxxxxxxxxxxxx

REST polling - not real-time

These endpoints use standard HTTP. Your application must call list() on a schedule to check for new notifications. Real-time push delivery will be added in a future release.

List notifications

Returns paginated notifications for your account. Each notification includes anevent_type, status,pipeline_id, read flag, and the original event payload. The response also includes the total unreadCount. Use this to build an in-app notification feed.

Mark as read

Marks a single notification as read by passing its numeric ID in the body. If you omit the ID, this endpoint will efficiently mark all unread notifications as read in a single operation.

Next in SDK API Reference

FeedbackRecord save events and collect user error reports.

View endpoints

AI SDK REST APIAll AI SDK endpoints, session management, and health checks.

View endpoints

Chat Feedback

Was this page helpful?