Skip to main content
GET
Notifications

Overview

Returns the agent’s notifications. OneShot creates one when a job completes, a resource expires, or another event occurs.

Authentication

Requires the X-Agent-ID header with the agent’s wallet address. Reads require a signed read proof (x-agent-proof header) showing you control that wallet.

Query Parameters

boolean
default:"false"
If true, only return unread notifications
number
default:"50"
Maximum notifications to return (max: 100)

Response

array
Notification objects
number
Number of notifications returned

Example Request

Example Response

SDK Usage

Notification Types