WAwarp
FactoriesInbox Notifications

List Factory inbox notifications

Changed on

List unresolved notifications across factories authorized for the authenticated principal and active team. The default mine scope preserves the personal Inbox and requires user credentials. The team scope lists notifications assigned to any recipient and can be used by user or agent credentials. Personal read state (is_read) is included only in mine scope and omitted in team scope, including when filtering by recipient.

get/factory-inbox

Request

  • Base URL
    https://app.warp.dev/api/v1
  • Auth
    HTTP bearer

Query parameters

scope'mine' | 'team'

Personal or team-wide Factory Inbox visibility.

mine returns notifications assigned to the authenticated user and is the default. team returns notifications across live recipients in the authorized Factory and team scope.

factory_uidstring

Exact Factory UID filter, intersected with authorized factories.

recipient_uidstring

Exact public user UID filter within the authorized Factory and team scope. In mine scope this can only match the authenticated user.

limitinteger

Maximum number of items to return. Defaults to 50.

cursorstring

Opaque cursor from page_info.next_cursor.

Headers

X-Warp-Team-Uidstring

UID of the team to use as the request's active team. Ignored for service-account callers, which always act as their bound team.

Response

One page of inbox notifications.

Changes