Notifications

Returns your notifications, newest first, without deleted ones. Non-numeric or non-positive values for limit and offset fall back to the defaults, and values above the maximum are reduced to it.

curl "https://app.hive3.tech/api/v1/notifications?unreadOnly=true&limit=20" \
  -H "Authorization: Bearer $HIVE_API_KEY"

const url = "https://app.hive3.tech/api/v1/notifications?unreadOnly=true&limit=20";
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.HIVE_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://app.hive3.tech/api/v1/notifications",
    params={"unreadOnly": "true", "limit": 20},
    headers={"Authorization": "Bearer " + os.environ["HIVE_API_KEY"]},
)
data = res.json()["data"]

Returns 200. To read the next page, send offset plus the number of items returned while hasMore is true. total is not a full count: it is the end of the current page, plus one when more items remain. unreadCount counts up to 1,000 unread notifications. data on each notification holds the notification's own fields plus actorId, entityType and entityId; account-valued fields are named personId or communityId.

{
  "data": {
    "notifications": [
      {
        "id": "notification_123",
        "type": "event_rsvp",
        "title": "New RSVP",
        "message": "Grace Hopper is attending Launch Night.",
        "read": false,
        "readAt": null,
        "createdAt": "2026-10-27T09:15:00.000Z",
        "data": { "actorId": "account_789", "entityType": "event", "entityId": "event_123" }
      }
    ],
    "hasMore": false,
    "total": 1,
    "unreadCount": 1
  }
}

Returns how many unread notifications you have, up to 1,000.

curl https://app.hive3.tech/api/v1/notifications/unread-count \
  -H "Authorization: Bearer $HIVE_API_KEY"

Returns 200.

{ "data": { "unreadCount": 3 } }

Marks a notification read. Marking a notification that is already read succeeds. Limited to 240 requests per minute.

curl -X POST https://app.hive3.tech/api/v1/notifications/notification_123/read \
  -H "Authorization: Bearer $HIVE_API_KEY"

Returns 200.

{ "data": { "id": "notification_123" } }

• 404 not_found: Notification not found, for an unknown ID, a deleted notification, or one that belongs to another account.

Marks every unread notification read, up to 5,000 per request. updated is the number of notifications changed; if it is large, call again until it reaches 0. There is no request body. Limited to 30 requests per minute.

curl -X POST https://app.hive3.tech/api/v1/notifications/mark-all-read \
  -H "Authorization: Bearer $HIVE_API_KEY"

Returns 200.

{ "data": { "updated": 12 } }

• 429 rate_limited: Too many notification updates.

Removes a notification from your inbox. It no longer appears in lists or in the unread count. Limited to 120 requests per minute.

curl -X DELETE https://app.hive3.tech/api/v1/notifications/notification_123 \
  -H "Authorization: Bearer $HIVE_API_KEY"

Returns 200.

{ "data": { "id": "notification_123", "removed": true } }

• 404 not_found: Notification not found.

Returns the account's mutes. id is the mute key, such as event:event_123. scopeId is null for system. createdAt is when the account's preferences were first saved, not when the mute was added.

curl https://app.hive3.tech/api/v1/notification-mutes \
  -H "Authorization: Bearer $HIVE_API_KEY"

Returns 200. Mutes saved with the community or person scope are listed as account.

{
  "data": {
    "mutes": [
      {
        "id": "event:event_123",
        "scope": "event",
        "scopeId": "event_123",
        "createdAt": "2026-10-01T09:30:00.000Z"
      }
    ]
  }
}

Adds or removes one mute. Muting something that is already muted, or unmuting something that is not, succeeds. Limited to 60 requests per minute; bodies are limited to 16 KiB.

curl -X PATCH https://app.hive3.tech/api/v1/notification-mutes \
  -H "Authorization: Bearer $HIVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scope":"event","scopeId":"event_123","muted":true}'

const res = await fetch("https://app.hive3.tech/api/v1/notification-mutes", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.HIVE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ scope: "event", scopeId: "event_123", muted: true }),
});
const { data } = await res.json();

import os, requests

res = requests.patch(
    "https://app.hive3.tech/api/v1/notification-mutes",
    headers={"Authorization": "Bearer " + os.environ["HIVE_API_KEY"]},
    json={"scope": "event", "scopeId": "event_123", "muted": True},
)
data = res.json()["data"]

Returns 200. For account scopes the response reports scope as account and scopeId as the account's ID.

{ "data": { "muted": true, "scope": "event", "scopeId": "event_123" } }

• 400 invalid_request: scope and muted are required, or scopeId is required for account mutes.
• 404 not_found: Account not found, when scopeId matches no account.
• 429 rate_limited: Too many notification mute updates.