# calendar_list

List Calendars

## Beschreibung

List your own and workspace-shared calendars in one account. Agent calls only see calendars shared with their authenticated workspace. Use cal_ IDs with event tools.

## Zugriff

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

## Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `account_id` | string | Ja | Account prefix ID (acct_…). |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Account prefix ID (acct_…)."
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "calendars": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "provider": {
            "type": "string",
            "enum": [
              "local",
              "google"
            ]
          },
          "time_zone": {
            "type": "string"
          },
          "writable": {
            "type": "boolean"
          },
          "last_synced_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "sync_error": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "provider",
          "time_zone",
          "writable"
        ]
      }
    }
  },
  "required": [
    "calendars"
  ],
  "type": "object"
}
```