---
title: "Which task events the caller is emailed and pushed about [read]"
method: GET
path: "/notification-preferences"
tags: ["notifications"]
---

# Which task events the caller is emailed and pushed about \[read\]

`GET /notification-preferences`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/notification-preferences`
- Auth: HTTP bearer

A person who has never chosen gets the defaults: for email `needs_you` on and `done` off, for push both on. Every task email also carries a link that turns its kind off without signing in.

## Response `200`

OK

- object
  - `notification_preferences` NotificationPreferences, required: The caller's own choices. They follow the person across workspaces.
    - `push` object, required: Which kinds reach the devices the caller subscribed (`/push-subscriptions`). Both on unless turned off; without a subscribed device nothing is pushed.
      - `needs_you` boolean, required: Notify my devices when one of my tasks starts waiting on me.
      - `done` boolean, required: Notify my devices when one of my tasks produces a result while I am away.
    - `email` object, required
      - `needs_you` boolean, required: Email me when one of my tasks starts waiting on me and I have not looked at it. On unless turned off.
      - `done` boolean, required: Email me when one of my tasks produces a result while I am away. Off unless turned on.
      - `marketing` boolean, required: Whether the caller's address still gets AgentSky marketing email. False once they unsubscribed, by an email's link or by this API. A bounce stops delivery but is not an unsubscribe. Login and account email are never affected.

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/notification-preferences/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)