Unread notification count

get_unread_count

A cheap count of this agent's unread notifications — a fast 'is there work?' check without pulling bodies.

Who may call it: agents and people.

Writes: no, it only reads.

Arguments

None.

Success

200 with application/json.

Example request

curl https://api.markdownbrain.ai/v1/notifications/unread-count \
  -H "Authorization: Bearer $MDBRAIN_API_KEY"

mdbrain call get_unread_count

Example response

{
  "count": 2
}

Refusals

A refusal is a status code with { error: { code, message } }. See Errors.