# list_inboxes

Verhalten, Eingaben, Ausgaben und Freigaben für list_inboxes.

Source: https://docs.getridian.com/de/developers/tools/list_inboxes/
Language: de
Reviewed: 2026-10-06

Diese Referenz wird aus dem veröffentlichten Werkzeugvertrag erzeugt. Feldnamen und normative Beschreibungen im Schema sind Englisch.

## Verhalten und Grenzen

Listet Agent Mailboxes der aktuellen Clientauswahl im Workspace mit ID, Name, Adresse und Empfangsstatus. managementUrl führt zur Verwaltung; ganze Postfächer werden nur dort gelöscht. allowance liefert den aktuellen Tarif, limit/used/remaining des persönlichen Workspace-Kontingents, canCreate, blockedReason und retryAt (Millisekunden-Zeitstempel oder null). Die Nutzung zählt alle eigenen nicht gelöschten Postfächer, auch deaktivierte oder von der Clientauswahl ausgeschlossene. Free prüft zusätzlich den personenweiten kostenlosen Platz, das Erstellungslimit gilt über Workspaces. remaining ist rechnerische Kapazität, keine Erstellungszusage: canCreate und blockedReason beachten. Keine fremden Workspace-Kennungen, Nachrichteninhalte oder Google-/Microsoft-Postfächer.

## Berechtigungen

Freigegebene Scopes, Konten, Kalender und Sichtbarkeitsregeln begrenzen den Zugriff. Ein Workspace-Admin erhält dadurch keinen pauschalen Zugriff auf fremde Konten.

`inbox:read`

[Freigaben und Grenzen](https://docs.getridian.com/de/developers/authentication/)

## Eingabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## Ausgabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "allowance": {
      "type": "object",
      "properties": {
        "plan": {
          "type": "string",
          "enum": [
            "free",
            "basic",
            "professional"
          ]
        },
        "limit": {
          "type": "number"
        },
        "used": {
          "type": "number"
        },
        "remaining": {
          "type": "number"
        },
        "canCreate": {
          "type": "boolean"
        },
        "blockedReason": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "INBOX_MAILBOX_LIMIT",
                "INBOX_FREE_MAILBOX_LIMIT",
                "INBOX_CREATION_RATE_LIMIT",
                "INBOX_CLIENT_ACCESS_DENIED"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "retryAt": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "plan",
        "limit",
        "used",
        "remaining",
        "canCreate",
        "blockedReason",
        "retryAt"
      ],
      "additionalProperties": false
    },
    "managementUrl": {
      "type": "string"
    },
    "mailboxes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "name": {
            "type": "string"
          },
          "address": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "canManage": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "name",
          "address",
          "enabled",
          "canManage"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "allowance",
    "managementUrl",
    "mailboxes"
  ],
  "additionalProperties": false
}
```

## Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den aktuellen Ressourcen- oder Sendestatus.

[Fehlerbehandlung](https://docs.getridian.com/de/developers/errors/)