:::endpoint GET /v1/me/calendar/calendars

The first thing an app asks for, because everything else is keyed on a calendar:
appointments are drawn in these colours and a new one has to land in one of
these.

An account that has never opened a calendar gets its personal one made here, and
so does the workspace's own calendar, so this always returns at least two rows.

## Request

```bash
curl https://api.proppertrading.com/v1/me/calendar/calendars \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f"
```

## Response

```json
{
    "data": [
        {
            "id": 12,
            "object": "calendar",
            "name": "Sarah Klein",
            "color": "blue",
            "timezone": "Europe/Amsterdam",
            "is_team": false,
            "is_global": false,
            "is_primary": true,
            "is_mine": true,
            "owner": null,
            "access": "manage"
        },
        {
            "id": 18,
            "object": "calendar",
            "name": "Support",
            "color": "pink",
            "timezone": "Europe/Amsterdam",
            "is_team": true,
            "is_global": false,
            "is_primary": false,
            "is_mine": false,
            "owner": null,
            "access": "write"
        }
    ],
    "meta": { "request_id": "req_01kz4bkr1aj1gv63d8fv3133ey" }
}
```

| Field        | Description                                                                                                                                |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `is_team`    | A calendar of the whole firm rather than of one person. Everybody who may open the calendar at all can read it                             |
| `is_global`  | The one calendar of the workspace itself. Everybody has it, it is always there, and only an account that may manage calendars writes in it |
| `is_primary` | The one appointments land in when nothing says otherwise                                                                                   |
| `is_mine`    | Yours, as opposed to a colleague's or the team's                                                                                           |
| `owner`      | The colleague it belongs to, and null on your own and on the team's                                                                        |
| `access`     | `busy`, `read`, `write` or `manage`. See [the overview](/docs/api/calendar/overview) for what each one hands over                          |

## Errors

| Status | Code                     | Meaning                                    |
| ------ | ------------------------ | ------------------------------------------ |
| 403    | `insufficient_scope`     | This device does not hold `calendar:read`  |
| 403    | `calendar_not_permitted` | The account may not open a calendar at all |