# agent_reminder_list_due

List Due Agent Reminders

## Beschreibung

Call this at the very start of every session, before doing
anything else. It returns the reminders you previously
scheduled for yourself that are now due — i.e. `due_at <=
now`, not yet completed, and created within the last 14 days.
Reminders older than 14 days are auto-hidden so the inbox
doesn't grow unbounded.

Sorted by `due_at` ascending — oldest-due first, so the most
overdue work surfaces immediately.

Workflow per row: read the `prompt`, do the work, then call
`agent_reminder_upsert` with the row's `id` and
`completed: true`. If the situation changed and you want to
defer instead, call `agent_reminder_upsert` with the same
`id` and a new `due_at`.

Filters (all optional):
- `subject` — exact match (e.g. `"task:ENG-123"`).
- `tags` — match if the reminder has *any* of these tags.
- `limit` — default 50, max 200.

Returns *your own* reminders only; other users' reminders
are invisible.

## Zugriff

Zugriffsprofil: `gated`. Module: `none`.
Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

## Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `account_id` | string | Ja |  |
| `subject` | string | Nein |  |
| `tags` | array | Nein |  |
| `limit` | integer | Nein | Max rows (default 50, max 200). |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "subject": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "description": "Max rows (default 50, max 200)."
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "reminders": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "prompt": {
            "type": "string"
          },
          "subject": {
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "due_at": {
            "type": "string"
          },
          "completed_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "prompt",
          "tags",
          "due_at",
          "created_at"
        ]
      }
    }
  },
  "required": [
    "reminders"
  ],
  "type": "object"
}
```