create_inbox

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

Verhalten und Grenzen

Legt eine Agent Mailbox auf der konfigurierten Ridian-Domain an. Benötigt inbox:manage, alle bestehenden und künftigen eigenen Postfächer in der Policy und einen freien Tarifplatz. Ein kostenloses Postfach pro Person über alle Workspaces; bezahlte Kontingente gelten je Workspace. Höchstens 20 erfolgreiche Erstellungen pro Person innerhalb rollierender 24 Stunden über alle Workspaces und Clients; Löschen setzt diese Grenze nicht zurück. localPart: 3–40 Kleinbuchstaben, Ziffern oder Bindestriche; reservierte/vergebene Adressen sind gesperrt. Liefert ID, vollständige Adresse und managementUrl für das Postfach in Ridian. Kein Agentlauf oder Versand. Bei unklarem Ergebnis vor erneutem Anlegen list_inboxes nutzen.

Berechtigungen

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

inbox:manage

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "localPart": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{2,39}$"
    }
  },
  "required": [
    "name",
    "localPart"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "address": {
      "type": "string"
    },
    "managementUrl": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "address",
    "managementUrl"
  ],
  "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