| name | send_notification |
| description | Send a notification to the human user's Inbox. Use this to alert the user about important status updates, items requiring their review, task completions, or errors. |
Send Notification
Send a notification that appears in the human user's Inbox.
When to Notify
- Status updates: Important progress on long-running work
- Review needed: When you've produced something that needs human review (e.g. a PR, a plan, a document)
- Completion: When a significant task or request is finished
- Errors: When something fails and needs human attention
Usage
python3 scripts/send_notification.py <base_url> \
--room-id "<room_id>" \
--agent-id "<your_agent_id>" \
--message "Your notification message here"
Examples
Notify about a completed task:
python3 scripts/send_notification.py https://oz-desktop.vercel.app \
--room-id "abc123" \
--agent-id "agent456" \
--message "Finished implementing the auth middleware. PR is ready for review."
Notify about an error:
python3 scripts/send_notification.py https://oz-desktop.vercel.app \
--room-id "abc123" \
--agent-id "agent456" \
--message "Build failed: missing dependency 'lodash'. Needs human intervention."
Response
The script outputs a JSON object with:
status_code: HTTP status code (201 on success)
body: The created notification object
error: Error message (only if request failed)