{
  "openapi": "3.0.3",
  "info": {
    "title": "Parro REST API (unofficial)",
    "version": "224",
    "description": "Description of the REST API behind **talk.parro.com**, the Dutch parent–school\ncommunication app by Topicus (ParnasSys). The API is a Topicus *geon* API. Every operation reads,\nexcept the three under **Read state**, which mark items as read, `sendChatMessage`, which sends a\nmessage to real people, `deleteChatMessage`, which deletes one, `addCommitment` and `deleteCommitment` under **Helpers**, and `answerRsvp`\nunder **RSVP**.\nThis spec was derived from the web client's traffic: a captured browser session and sanitized response\nsamples. Response schemas list **only fields seen in those samples**. Treat every object as\nopen: geon adds fields between contract versions. Every operation here was called at least once;\ntwo paths from the web app's code, `/conversations` and `/timeslot`, answered `404` and are left out.\n\n**A client for this API:** [parro-api-client](https://github.com/chris-swift-dev/parro-api-client),\na command-line client and MCP server in plain Python that reads, and only when you ask marks items\nas read and sends chat messages\n([download a release](https://github.com/chris-swift-dev/parro-api-client/releases/latest)).\n\nInspired by [fobatai/parro-mcp](https://github.com/fobatai/parro-mcp), a read-only MCP server for Parro\nwhose working login and API calls were the starting point for this specification.\n\n## Conventions\n* **Media type**: `Accept: application/vnd.topicus.geon+json;version=224`. The official client also\n  sends the same value as `Content-Type`, even on GET. Responses sometimes omit `;version=…`.\n* **Client headers**: `parro-app-version: web:2.27.0` and `parro-authorization-role: GUARDIAN:<guardianId>`.\n  Derive the role from `GET /account/me`, which is called *without* the role header:\n  the id is the `rel: self` link id of the first entry in `identity.guardians`.\n* **Polymorphism**: every object carries a `dtype` (e.g. `event.RAnnouncementEventPrimer`). Several\n  endpoints select the returned type with a `dtype` query parameter.\n* **Ids** are 64-bit integers, found in `links[rel=self].id`. `href` values point at item resources\n  (`/child/{id}`, `/group/{id}`, …) that are not described here.\n* **Collections** come as `{\"items\": [...]}`. They are paged with `Range: items=<from>-<to>` and answer\n  `206 Partial Content` with `Content-Range: items 0-1/2`, **even without a `Range` header**\n  (the server's default page size is unknown). Add `topicus-Range-Count: Exact` to get an exact total.\n* **Dates** are ISO-8601 with an offset. Fractional seconds vary from none to 3 digits.\n* **CORS preflights** answer `Access-Control-Allow-Methods: DELETE, POST, GET, OPTIONS, PUT` on\n  every path, even read-only ones such as `/child`. It is a server-wide setting and says nothing\n  about which methods a path supports.\n\n## Authentication\nOAuth2 against the ParnasSys IdP (`https://inloggen.parnassys.net`, see the **Auth** operations).\nThe public client `MQygAaSBUcAgPU2WInKt` is pinned to the redirect URI `https://talk.parro.com/oauth2`.\nThere is no dynamic client registration or device grant, and loopback redirects are rejected.\n* **Authorization code + PKCE (S256)**: browser login. Copy the `code` from the redirect URL quickly,\n  because the web app also tries to redeem it and a code works only once.\n* **Password grant**: `grant_type=password`, enabled for this client.\n* A login lasts at most **8 hours**: the refresh token expires 8 hours after the login, also with scope\n  `openid offline_access`, and a refresh returns a new refresh token with the same expiry (measured\n  2026-11-06). The access token lasts 1 hour.\n* The IdP **locks the account after a few failed logins**. Never retry a rejected password automatically.\n\n## Attachments\nAttachment entries carry a CloudFront `url`. It is **unsigned and needs no authentication**: anyone holding\nit can download the file, so treat these URLs as secrets. Never send the Parro `Authorization` header to the CDN.\nDocument entries also carry `expiresAt`, exactly one year after the announcement in the sample. Whether the CDN\nenforces it is unknown.\nAnnouncements keep attachments in `attachments[]`; calendar items in `calendarItem.attachments[]`; a chat\nmessage has at most one, in `attachment`.\nEntries have a `type`: `SOURCE` is the original file; `THUMBNAIL` a small picture of a photo or a video; `VIDEO`\na video prepared for streaming. Their order varies, so pick an entry by `type`. A photo's entries have no\n`filename`.\nA calendar item can also carry a web address the teacher added: `calendarItem.url`, only in `GET /event/{id}`,\nnot in the list.\nChoose the parser by `contentType`, not by the entry's `dtype`: a photo's SOURCE entry can be a\n`RAttachmentDocumentEntry`.\n\n## Trying it out\nPaste an access token into **Authorize → bearerToken**. \"Try it out\" then works for the API operations,\nincluding from a Swagger UI hosted on GitHub Pages: the API accepts cross-origin requests. The generated\ncurl commands include the token as well.\n\n> ⚠️ **Logging in does not work from Swagger UI.** Leave the **parnassysOAuth** scheme and the **Auth**\n> operations alone in the browser, and get the token outside it (see `/oauth2/token`):\n> * *Authorization code*: the redirect URI is pinned to `https://talk.parro.com/oauth2`, so Swagger UI never\n>   receives the code.\n> * *Password*: the IdP answers `invalid_grant` for accounts it will not put through the password grant\n>   (seen in practice), and cross-origin calls to the IdP are untested. **Every rejected attempt can count\n>   toward the account lockout**, including the \"Request body\" variant, whose response the page may not\n>   even be allowed to read.\n\n## About this build\nPublic build: response and property examples taken from samples are left out.\n",
    "license": {
      "name": "CC BY 4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    },
    "x-parro-app-version": "web:2.27.0"
  },
  "servers": [
    {
      "url": "https://rest-v2.parro.com/rest/v2",
      "description": "Production"
    },
    {
      "url": "https://{host}/rest/v2",
      "description": "Other environment (e.g. acceptance; host not documented)",
      "variables": {
        "host": {
          "default": "rest-v2.parro.com"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Auth",
      "description": "ParnasSys IdP (OAuth2 / OpenID Connect)."
    },
    {
      "name": "Account",
      "description": "Account, school, children, unread counts."
    },
    {
      "name": "Groups",
      "description": "Classes and school-wide groups."
    },
    {
      "name": "Events",
      "description": "Announcements (mededelingen) and calendar items, incl. attachments."
    },
    {
      "name": "Chat",
      "description": "Conversations with teachers."
    },
    {
      "name": "Misc",
      "description": "System news, absence and photo-export settings."
    },
    {
      "name": "Read state",
      "description": "Mark announcements, calendar items and chats as read."
    },
    {
      "name": "Helpers",
      "description": "Sign up on a calendar item's helper slot, or withdraw."
    },
    {
      "name": "RSVP",
      "description": "Answer a calendar item's invitation."
    }
  ],
  "security": [
    {
      "bearerToken": []
    },
    {
      "parnassysOAuth": [
        "openid"
      ]
    }
  ],
  "paths": {
    "/account/me": {
      "get": {
        "tags": [
          "Account"
        ],
        "operationId": "getAccountMe",
        "summary": "The logged-in account, its identity, school and guardian ids",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/Account"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Call **without** `parro-authorization-role`; the role is derived from this response."
      }
    },
    "/accountsettings": {
      "get": {
        "tags": [
          "Account"
        ],
        "operationId": "getAccountSettings",
        "summary": "Notification, digest, translation and chat preferences",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/AccountSettings"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/organisation/{id}": {
      "get": {
        "tags": [
          "Account"
        ],
        "operationId": "getOrganisation",
        "summary": "The school (organisation)",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "From `/account/me` → `organisation`."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/OrganisationPrimer"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/child": {
      "get": {
        "tags": [
          "Account"
        ],
        "operationId": "listChildren",
        "summary": "Children linked to the account",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          },
          {
            "name": "dtype",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "identity.RPrivacySettingChild"
              ]
            },
            "description": "Return the privacy variant."
          },
          {
            "name": "currentSchoolYear",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "Sent with the privacy variant by the web app; its effect is unknown."
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "$ref": "#/components/schemas/ChildPrimer"
                          },
                          {
                            "$ref": "#/components/schemas/PrivacySettingChild"
                          }
                        ],
                        "discriminator": {
                          "propertyName": "dtype",
                          "mapping": {
                            "identity.RChildPrimer": "#/components/schemas/ChildPrimer",
                            "identity.RPrivacySettingChild": "#/components/schemas/PrivacySettingChild"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "$ref": "#/components/schemas/ChildPrimer"
                          },
                          {
                            "$ref": "#/components/schemas/PrivacySettingChild"
                          }
                        ],
                        "discriminator": {
                          "propertyName": "dtype",
                          "mapping": {
                            "identity.RChildPrimer": "#/components/schemas/ChildPrimer",
                            "identity.RPrivacySettingChild": "#/components/schemas/PrivacySettingChild"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Without parameters: `RChildPrimer` per child. With `currentSchoolYear=true&dtype=identity.RPrivacySettingChild` (what the web app sends for its privacy page): `RPrivacySettingChild`, the same fields plus `setting`, the state of the child's privacy choices: `editableForGuardians`, `editableInPeriod`, `state` and who changed them last. The choices themselves are not in the API; `GET /child/{id}/privacy` gives the link to the page where they are set."
      }
    },
    "/child/{id}/privacy": {
      "get": {
        "tags": [
          "Account"
        ],
        "operationId": "getChildPrivacy",
        "summary": "Link to the page where a child's privacy choices are set",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Child id from `GET /child`."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/PrivacySettings"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "`url` is a link to `https://start.parnassys.net/bao/privacy?signedpermission=<signature>`, the ParnasSys page where a parent sets the child's privacy choices (photos, data). `defined` was `true` in the capture.\n\n⚠️ **The link is signed**: it opens the page without a login. Treat it as a secret; do not share or log it."
      }
    },
    "/identity/unreadcounts": {
      "get": {
        "tags": [
          "Account"
        ],
        "operationId": "getUnreadCounts",
        "summary": "Unread counts per category, per guardian identity",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/UnreadCount"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/UnreadCount"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/group": {
      "get": {
        "tags": [
          "Groups"
        ],
        "operationId": "listGroups",
        "summary": "Classes and school-wide groups",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          },
          {
            "name": "dtype",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "identity.RHomeGroup"
              ]
            },
            "description": "Current groups."
          },
          {
            "name": "scope",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "PREVIOUS_ACTIVE"
              ]
            },
            "description": "Previous school year."
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "$ref": "#/components/schemas/HomeGroup"
                          },
                          {
                            "$ref": "#/components/schemas/GroupPrimer"
                          }
                        ],
                        "discriminator": {
                          "propertyName": "dtype",
                          "mapping": {
                            "identity.RHomeGroup": "#/components/schemas/HomeGroup",
                            "identity.RGroupPrimer": "#/components/schemas/GroupPrimer"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "$ref": "#/components/schemas/HomeGroup"
                          },
                          {
                            "$ref": "#/components/schemas/GroupPrimer"
                          }
                        ],
                        "discriminator": {
                          "propertyName": "dtype",
                          "mapping": {
                            "identity.RHomeGroup": "#/components/schemas/HomeGroup",
                            "identity.RGroupPrimer": "#/components/schemas/GroupPrimer"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Pass **either** `dtype=identity.RHomeGroup` (current school year, returns `RHomeGroup` with `lastAnnouncement`) **or** `scope=PREVIOUS_ACTIVE` (last school year, returns `RGroupPrimer`). The group ids feed `GET /event?group=`."
      }
    },
    "/event": {
      "get": {
        "tags": [
          "Events"
        ],
        "operationId": "listEvents",
        "summary": "Announcements or calendar items of one group",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          },
          {
            "name": "dtype",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "event.RAnnouncementEventPrimer",
                "event.RCalendarItemEventPrimer"
              ]
            },
            "description": "Which event type to list."
          },
          {
            "name": "group",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Group id from `GET /group`."
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "$ref": "#/components/schemas/AnnouncementEventPrimer"
                          },
                          {
                            "$ref": "#/components/schemas/CalendarItemEventPrimer"
                          }
                        ],
                        "discriminator": {
                          "propertyName": "dtype",
                          "mapping": {
                            "event.RAnnouncementEventPrimer": "#/components/schemas/AnnouncementEventPrimer",
                            "event.RCalendarItemEventPrimer": "#/components/schemas/CalendarItemEventPrimer"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "$ref": "#/components/schemas/AnnouncementEventPrimer"
                          },
                          {
                            "$ref": "#/components/schemas/CalendarItemEventPrimer"
                          }
                        ],
                        "discriminator": {
                          "propertyName": "dtype",
                          "mapping": {
                            "event.RAnnouncementEventPrimer": "#/components/schemas/AnnouncementEventPrimer",
                            "event.RCalendarItemEventPrimer": "#/components/schemas/CalendarItemEventPrimer"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "The main feed. Query each group separately and merge by `sortDate`.\n\n**Order: newest first.** For calendar items that means the *furthest future* first: in a live check (2026-11-05) a whole-school group's first 50 of 100 items lay 6 to 9 months ahead, so the coming weeks were on page 2. Page with `Range` until the dates reach today.\n\n**Duplicates:** an announcement sent to several groups is returned once per group (same id; 2 of 71 events in that check). Merge by id.\n\n**Multi-day calendar items come once per day**: each day is its own entry with its own event id, `dayNumber` (1..`numberOfDays`) and `sortDate`, all sharing one `calendarItem` (same id, `startDate`, `endDate`, `dayDates`). In that check one 40-day item gave 40 entries. Merge by `calendarItem` id.\n\n**No read filter:** `read=false` is accepted and ignored (live check 2026-11-07: the same 36 announcements with and without it, 3 of them unread). Filter on `read` yourself."
      }
    },
    "/event/{id}": {
      "get": {
        "tags": [
          "Events"
        ],
        "operationId": "getEvent",
        "summary": "One announcement or calendar item",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Event id (`links[rel=self].id` from `GET /event`)."
          },
          {
            "name": "dtype",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "event.RAnnouncementEventPrimer",
                "event.RCalendarItemEvent"
              ]
            },
            "description": "Concrete event type."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/AnnouncementEventPrimer"
                    },
                    {
                      "$ref": "#/components/schemas/CalendarItemEvent"
                    }
                  ],
                  "discriminator": {
                    "propertyName": "dtype",
                    "mapping": {
                      "event.RAnnouncementEventPrimer": "#/components/schemas/AnnouncementEventPrimer",
                      "event.RCalendarItemEvent": "#/components/schemas/CalendarItemEvent"
                    }
                  }
                }
              }
            }
          },
          "406": {
            "description": "Missing or abstract `dtype`.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/GeonError"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "`dtype` is required. Without it the API answers `406 EVENT_BAD_TYPE` (abstract supertype `RAbstractEvent`). **Pitfall:** `dtype=event.RAnnouncementEvent` answers **401**, not 406. Use `event.RAnnouncementEventPrimer` for announcements. A client that treats every 401 as an expired token will loop through logins."
      }
    },
    "/calendar/sync": {
      "get": {
        "tags": [
          "Events"
        ],
        "operationId": "getCalendarSync",
        "summary": "Personal iCalendar link for subscribing to the agenda",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/Strings"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Returns the account's personal **agenda subscription link** in `strings[0]`: `https://calendar.parro.com/ical/<calendarId>/<token>?noCache=<uuid>`. Calendar apps (Google, Apple, Outlook) subscribe to it and update by themselves; this is what the app's \"sync the agenda\" option copies.\n\n⚠️ **The link is a secret**: anyone who has it can read the calendar, without logging in. Do not share or log it.\n\nChecked live (2026-11-05):\n* `calendarId` is none of the account, identity, guardian or organisation ids.\n* The token stays the same across calls; only `noCache` changes. The link works without `noCache` (same content, same ETag).\n* `GET` on the link needs no authentication and answers `200 text/calendar` (iCalendar with VTIMEZONE, `REFRESH-INTERVAL` and `X-PUBLISHED-TTL` of 1 hour). It holds the school year's items, each multi-day item once.\n\nNot verified: ParnasSys lists agenda syncing as a feature of the paid *Parro Ouderapp*, so with *Parro Basis* this call may fail or return no link."
      }
    },
    "/calendaritem/{id}": {
      "get": {
        "tags": [
          "Events"
        ],
        "operationId": "getCalendarItem",
        "summary": "One calendar item, directly",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Calendar item id (`calendarItem.links[rel=self].id` from `GET /event`)."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarItem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "The same `calendar.RCalendarItem` that `GET /event/{id}` embeds as `calendarItem` (without `lastEditedBy`), addressed by the calendar item's own id.\n\nItems of `type: VOLUNTEER` or `SCHOOLWIDE_VOLUNTEER` (seen live) ask for helpers: each entry in `resources[]` (`RCalendarItemVolunteerResource`) has a `title`, `amount` (helpers wanted), `amountCommitted`, `commitedByMe` (sic) and `commitments[]`, which lists only your own. `numberOfTimeslots` and the `RCalendarItemTimeslotCreate` permission point to timeslots (e.g. parent–teacher talks) that hang off calendar items; their path is not known."
      }
    },
    "/systemnews": {
      "get": {
        "tags": [
          "Misc"
        ],
        "operationId": "listSystemNews",
        "summary": "Product news from Parro itself",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SystemNewsEvent"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SystemNewsEvent"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/absence/setting": {
      "get": {
        "tags": [
          "Misc"
        ],
        "operationId": "getAbsenceSetting",
        "summary": "Absence-reporting settings",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GeonObject"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GeonObject"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Returned `{\"items\": []}` in every capture, so the item type is unknown."
      }
    },
    "/absence": {
      "get": {
        "tags": [
          "Misc"
        ],
        "operationId": "listAbsences",
        "summary": "Absence reports",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GeonObject"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GeonObject"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Returned an empty page (`Content-Range: items 0-0/0`) in the only capture, so the item type is unknown. Reporting an absence is a write and is not described."
      }
    },
    "/media-export": {
      "get": {
        "tags": [
          "Misc"
        ],
        "operationId": "getMediaExport",
        "summary": "Media exports",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GeonObject"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GeonObject"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Answered `200` with `{\"items\": []}` (no `Content-Range`) in the only capture, so the item type is unknown. Probably the photo exports a parent has requested; requesting one is a write and is not described."
      }
    },
    "/media-export/settings": {
      "get": {
        "tags": [
          "Misc"
        ],
        "operationId": "getMediaExportSettings",
        "summary": "Whether the school allows downloading photos",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/MediaExportSettings"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/chatroom": {
      "get": {
        "tags": [
          "Chat"
        ],
        "operationId": "listChatrooms",
        "summary": "Chat conversations",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          },
          {
            "name": "chatRoom.type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "SINGLE",
                "BOT",
                "CALENDAR",
                "GROUP",
                "FAMILY"
              ]
            },
            "description": "Only chats of this type."
          },
          {
            "name": "read",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "`false`: only chats with unread messages."
          },
          {
            "name": "archived",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "FALSE",
                "TRUE",
                "BOTH"
              ],
              "default": "FALSE"
            },
            "description": "Uppercase only (`true` answers `400`). Without it: the chats that are not archived."
          },
          {
            "name": "chatRoom.createdInSchoolyear",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "example": 2025
            },
            "description": "Chats created in this school year (`GET /chatroom/schoolyears` lists them)."
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ChatRoomPrimer"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ChatRoomPrimer"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "**The chat room's id is its `rel: self` link.** The first link is `koppeling` (your membership); using that id answers `403 CHAT_NOT_ACTIVE_MEMBER` on every chat call.\n\nFilters (live check 2026-11-07): `chatRoom.type`, `read`, `archived` and `chatRoom.createdInSchoolyear`; an unknown enum value answers `400`."
      }
    },
    "/chatroom/schoolyears": {
      "get": {
        "tags": [
          "Chat"
        ],
        "operationId": "listChatSchoolyears",
        "summary": "School years that have chats",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Schoolyear"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "The values `chatRoom.createdInSchoolyear` accepts, newest first. A plain list: answered with `200` and no `Content-Range`."
      }
    },
    "/chatroom/{id}": {
      "get": {
        "tags": [
          "Chat"
        ],
        "operationId": "getChatroom",
        "summary": "One chat conversation",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Chatroom id: the `rel: self` link of `GET /chatroom`."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/ChatRoom"
                }
              }
            }
          },
          "403": {
            "description": "`CHAT_NOT_ACTIVE_MEMBER`: not a member, or the membership (`koppeling`) id was used instead of the chat room's own id."
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "The full chat room, with its members."
      }
    },
    "/chatroom/{id}/chatroommember": {
      "get": {
        "tags": [
          "Chat"
        ],
        "operationId": "listChatroomMembers",
        "summary": "Members of one chat conversation",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Chatroom id from `GET /chatroom`."
          },
          {
            "name": "isActive",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "Only active (or only former) members."
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ChatRoomMember"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ChatRoomMember"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Each member is a guardian or a teacher, with `admin`, `active`, `muted` and its own `unreadCount`."
      }
    },
    "/chatroom/{id}/scheduledchatmessage": {
      "get": {
        "tags": [
          "Chat"
        ],
        "operationId": "listScheduledChatMessages",
        "summary": "Your messages scheduled for later in a chat",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Chatroom id from `GET /chatroom`."
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "SCHEDULED"
              ]
            },
            "description": "The web app asks for `SCHEDULED`."
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GeonObject"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/GeonObject"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Empty in every capture, so the item type is unknown."
      }
    },
    "/chatroom/{id}/chatmessage": {
      "get": {
        "tags": [
          "Chat"
        ],
        "operationId": "listChatMessages",
        "summary": "Messages in one chat conversation",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Chatroom id from `GET /chatroom`."
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "desc-stream",
                "asc-stream"
              ]
            },
            "description": "`desc-stream`: oldest first; `asc-stream`: newest first. Both add status messages."
          },
          {
            "name": "createdSince",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "Only messages created since."
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "Only messages changed since."
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "$ref": "#/components/schemas/ChatTextMessage"
                          },
                          {
                            "$ref": "#/components/schemas/ChatStatusMessage"
                          }
                        ],
                        "discriminator": {
                          "propertyName": "dtype",
                          "mapping": {
                            "chat.RChatTextMessage": "#/components/schemas/ChatTextMessage",
                            "chat.RChatStatusMessage": "#/components/schemas/ChatStatusMessage"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "$ref": "#/components/schemas/ChatTextMessage"
                          },
                          {
                            "$ref": "#/components/schemas/ChatStatusMessage"
                          }
                        ],
                        "discriminator": {
                          "propertyName": "dtype",
                          "mapping": {
                            "chat.RChatTextMessage": "#/components/schemas/ChatTextMessage",
                            "chat.RChatStatusMessage": "#/components/schemas/ChatStatusMessage"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Messages come back **newest first** (live check 2026-11-05: `Range: items=0-29` returned the newest 30 of 89 messages). Reverse them for reading order.\n\nA message with a photo, video or document has an `attachment` and often no `text` at all. Status messages (`chat.RChatStatusMessage`: `status` is `ENTER`, `LEAVE` or `TITLE_CHANGED`, the last with the new `title`) have no text either. On 2026-11-05 a call without `sort` returned text messages only; on 2026-11-14 it returned status messages as well, so expect both.\n\nWith `sort` (what the web app sends), status messages (`chat.RChatStatusMessage`, e.g. someone joining) come back as well, and the names are the **opposite** of what they say: `desc-stream` is oldest first, `asc-stream` newest first (live check 2026-11-07).\n\n`createdSince` / `modifiedSince` (ISO 8601 with `Z`) return only messages created or changed since then: what the web app uses to fetch only new messages."
      },
      "post": {
        "tags": [
          "Chat"
        ],
        "operationId": "sendChatMessage",
        "summary": "Send a text message to a chat conversation",
        "description": "Adds a text message to an existing chat, as seen in a capture of the web app. The id is the chat room's `rel: self` link. Answered `201` with the new message, and its address in `Location`.\n\n⚠️ **Real people receive this, under your name:** the teacher, or everyone in a group chat. They get a notification. A message can be deleted afterwards (`deleteChatMessage`), but everyone still sees that there was one, and may have read it: treat sending as final.\n\n⚠️ **Do not resend blindly.** The request has no idempotency key: after a timeout there is no way to know whether the message arrived, so look at `GET /chatroom/{id}/chatmessage` first.\n\n**Not known** (finding out means messaging real people): the longest text allowed, the answer to empty text, and the answer for a chat that cannot be written to (`repliesEnabled: false`, `active: false`, archived, or `BOT`). Other kinds of message, replies and attachments were not captured.",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Chatroom id from `GET /chatroom`."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/vnd.topicus.geon+json;version=224": {
              "schema": {
                "type": "object",
                "required": [
                  "items"
                ],
                "properties": {
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "dtype",
                        "links",
                        "deleted",
                        "text",
                        "allRead"
                      ],
                      "description": "The web app sends exactly these five fields.",
                      "properties": {
                        "dtype": {
                          "type": "string",
                          "enum": [
                            "chat.RChatTextMessage"
                          ]
                        },
                        "links": {
                          "type": "array",
                          "maxItems": 0,
                          "items": {},
                          "description": "Empty: the message has no id yet."
                        },
                        "deleted": {
                          "type": "boolean",
                          "enum": [
                            false
                          ]
                        },
                        "text": {
                          "type": "string",
                          "description": "The message, as the recipients will read it."
                        },
                        "allRead": {
                          "type": "boolean",
                          "enum": [
                            false
                          ]
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Sent. One item: the new message.",
            "headers": {
              "Location": {
                "description": "`…/chatroom/{id}/chatmessage/{messageId}` of the new message.",
                "schema": {
                  "type": "string",
                  "format": "uri"
                }
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ChatTextMessage"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/chatroom/{id}/chatmessage/{messageId}": {
      "get": {
        "tags": [
          "Chat"
        ],
        "operationId": "getChatMessage",
        "summary": "One chat message",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Chatroom id from `GET /chatroom`."
          },
          {
            "name": "messageId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Message id from `GET /chatroom/{id}/chatmessage`."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/ChatTextMessage"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Reading one message leaves the chat's unread count as it was (live check 2026-11-14)."
      },
      "delete": {
        "tags": [
          "Chat"
        ],
        "operationId": "deleteChatMessage",
        "summary": "Delete a chat message",
        "description": "Deletes one message, as seen in a capture of the web app deleting a message of the user's own. No request body. Answered `204` without a body.\n\n⚠️ **It cannot be undone, and others see it.** The message stays in the list with `deleted: true` and without its `text` or `attachment`, so everyone in the chat sees that a message was deleted.\n\nA message's `permissions` list only `READ`, also for your own (live look 2026-11-14), so the API does not say which messages you may delete. Only deleting your own message was captured; what it answers for someone else's is not known.",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Chatroom id from `GET /chatroom`."
          },
          {
            "name": "messageId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Message id from `GET /chatroom/{id}/chatmessage`."
          }
        ],
        "responses": {
          "204": {
            "description": "Deleted. No body."
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/identity/{id}": {
      "get": {
        "tags": [
          "Account"
        ],
        "operationId": "getIdentity",
        "summary": "One identity (a parent, teacher or child)",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Identity id, e.g. `identity` in `GET /account/me`."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/Identity"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Called with your own identity id (from `GET /account/me`). The web app also uses it for the people you can start a chat with."
      }
    },
    "/event/{id}/attachment/{attachmentId}": {
      "get": {
        "tags": [
          "Events"
        ],
        "operationId": "getEventAttachment",
        "summary": "One attachment of an announcement",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Announcement id."
          },
          {
            "name": "attachmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Attachment id from the announcement's `attachments`."
          },
          {
            "name": "dtype",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "event.RAnnouncementEventPrimer"
              ]
            },
            "description": "The event type, as for `GET /event/{id}`."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "$ref": "#/components/schemas/AnnouncementAttachment"
                }
              }
            }
          },
          "406": {
            "description": "Missing `dtype`."
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Like `GET /event/{id}` it needs `dtype`: without it the API answers `406 EVENT_BAD_TYPE`. The path `…/attachment/{id}/attachmententry/{id}` from the web app's code answered `404` (with `dtype`) and `406` (without) in the live check, so it is not described."
      }
    },
    "/event/{id}/read": {
      "put": {
        "tags": [
          "Read state"
        ],
        "operationId": "markEventRead",
        "summary": "Mark one announcement or calendar item as read",
        "description": "No request body. Answered `204` in the capture (an announcement).\n\n⚠️ **Others see it.** Read state is shared: the item is no longer marked new in the Parro app on your phone, and the school sees it as read (announcements show teachers how many parents read them; chats have read receipts). Mark an item only once you have read it.",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Event id (`links[rel=self].id` from `GET /event`)."
          }
        ],
        "responses": {
          "204": {
            "description": "Marked as read. No body."
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/event/markannouncementsasread": {
      "put": {
        "tags": [
          "Read state"
        ],
        "operationId": "markGroupAnnouncementsRead",
        "summary": "Mark all announcements of a group as read",
        "description": "No request body. Answered `204` in the capture. It marks **every** announcement of the group, not only the ones you have seen.\n\n⚠️ **Others see it.** Read state is shared: the item is no longer marked new in the Parro app on your phone, and the school sees it as read (announcements show teachers how many parents read them; chats have read receipts). Mark an item only once you have read it.",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "group",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Group id from `GET /group`."
          }
        ],
        "responses": {
          "204": {
            "description": "Marked as read. No body."
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/chatroom/{id}/read": {
      "put": {
        "tags": [
          "Read state"
        ],
        "operationId": "markChatroomRead",
        "summary": "Mark a chat conversation as read",
        "description": "No request body. Answered `204` in the capture. The id is the chat room's `rel: self` link.\n\n⚠️ **Others see it.** Read state is shared: the item is no longer marked new in the Parro app on your phone, and the school sees it as read (announcements show teachers how many parents read them; chats have read receipts). Mark an item only once you have read it.",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Chatroom id from `GET /chatroom`."
          }
        ],
        "responses": {
          "204": {
            "description": "Marked as read. No body."
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/calendaritem/{id}/resource/{resourceId}/commitment": {
      "get": {
        "tags": [
          "Helpers"
        ],
        "operationId": "listCommitments",
        "summary": "Your own commitment on a helper slot",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "The calendar item's **own** id (`calendarItem.links[rel=self].id`), not the event id: the event id answers `404`."
          },
          {
            "name": "resourceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "The slot's id (`calendarItem.resources[].links[rel=self].id`)."
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CalendarItemResourceCommitmentPrimer"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CalendarItemResourceCommitmentPrimer"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "Lists **only your own** commitment on the slot (live check 2026-11-08), even when `amountCommitted` shows that others signed up: it is empty where you did not. The same entry is in `resources[].commitments[]` of the calendar item. The path also answers with a trailing `/`."
      }
    },
    "/calendaritem/{id}/resource/{resourceId}/commitment/": {
      "post": {
        "tags": [
          "Helpers"
        ],
        "operationId": "addCommitment",
        "summary": "Sign up on a helper slot",
        "description": "Adds a commitment for the logged-in parent, as seen in a capture of the web app, with the trailing `/`. Answered `201` with the new commitment, and its address in `Location`. Slots are people (`type: VOLUNTEER`) or things to bring (`EQUIPMENT`).\n\n`amount` is how many places you take, for example how many children a parent can take along. Captures send `1`; `2` was accepted in a live check (2026-11-08), and `amountCommitted` rose by 2 and `commitedByMe` became 2.\n\n**Not known** (finding out means changing real slots): the answer for a full slot, a past item or closed sign-ups, and whether a second sign-up on the same slot adds up.\n\n⚠️ **Others see it.** The school sees your name on the slot; a parent sees how many signed up, not who (`GET` answers show only your own commitment). A sign-up is a promise, and it can take the last place from another parent; withdrawing can leave the school short.",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "The calendar item's **own** id (`calendarItem.links[rel=self].id`), not the event id: the event id answers `404`."
          },
          {
            "name": "resourceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "The slot's id (`calendarItem.resources[].links[rel=self].id`)."
          }
        ],
        "responses": {
          "201": {
            "description": "Signed up. One item: the new commitment.",
            "headers": {
              "Location": {
                "description": "`…/commitment/{commitmentId}` of the new commitment.",
                "schema": {
                  "type": "string",
                  "format": "uri"
                }
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CalendarItemResourceCommitmentPrimer"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/vnd.topicus.geon+json;version=224": {
              "schema": {
                "type": "object",
                "required": [
                  "items"
                ],
                "properties": {
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "dtype",
                        "links",
                        "amount"
                      ],
                      "description": "The web app sends exactly these three fields.",
                      "properties": {
                        "dtype": {
                          "type": "string",
                          "enum": [
                            "calendar.RCalendarItemResourceCommitmentPrimer"
                          ]
                        },
                        "links": {
                          "type": "array",
                          "maxItems": 0,
                          "items": {},
                          "description": "Empty: the commitment has no id yet."
                        },
                        "amount": {
                          "type": "integer",
                          "minimum": 1,
                          "description": "How many places you take."
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/calendaritem/{id}/resource/{resourceId}/commitment/{commitmentId}": {
      "delete": {
        "tags": [
          "Helpers"
        ],
        "operationId": "deleteCommitment",
        "summary": "Withdraw from a helper slot",
        "description": "Removes your commitment. Answered `204` in a capture of the web app. No request body. The id is in `resources[].commitments[]` of the calendar item, which lists only your own.\n\n⚠️ **Others see it.** The school sees your name on the slot; a parent sees how many signed up, not who (`GET` answers show only your own commitment). A sign-up is a promise, and it can take the last place from another parent; withdrawing can leave the school short.",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "The calendar item's **own** id (`calendarItem.links[rel=self].id`), not the event id: the event id answers `404`."
          },
          {
            "name": "resourceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "The slot's id (`calendarItem.resources[].links[rel=self].id`)."
          },
          {
            "name": "commitmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Your commitment's id (`commitments[].links[rel=self].id`)."
          }
        ],
        "responses": {
          "204": {
            "description": "Withdrawn. No body."
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/calendaritem/{id}/calendaritemrsvp": {
      "get": {
        "tags": [
          "RSVP"
        ],
        "operationId": "listRsvpRespondents",
        "summary": "Everyone invited, with their answers",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "$ref": "#/components/parameters/Range"
          },
          {
            "$ref": "#/components/parameters/RangeCount"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "The calendar item's **own** id (`calendarItem.links[rel=self].id`), not the event id: the event id answers `404`."
          }
        ],
        "responses": {
          "206": {
            "description": "A page of the collection (observed even without `Range`).",
            "headers": {
              "Content-Range": {
                "$ref": "#/components/headers/ContentRange"
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Respondent"
                      }
                    }
                  }
                }
              }
            }
          },
          "200": {
            "description": "Same body as 206. Not observed for paged lists, but clients should accept it.",
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Respondent"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        },
        "description": "⚠️ **Personal data of other people.** Lists everyone the invitation went to, parents and teachers: first name, surname, children's names, avatar and answer. Handle it with care, and do not pass it on.\n\n`rsvp` is `ACCEPT`, `DECLINE`, `TENTATIVE`, or `UNKNOWN` for someone who has not answered. Seen in a live check (2026-11-09): it answered on 15 of 20 items and `403` on the other 5, for reasons not known. You do not need it for your own answer: that is the `rsvp` field of the event in `GET /event` and `GET /event/{id}`, absent until you answer."
      },
      "post": {
        "tags": [
          "RSVP"
        ],
        "operationId": "answerRsvp",
        "summary": "Answer a calendar item's invitation",
        "description": "Stores your answer, as seen in a capture of the web app. Answered `201` with the answer, and its address in `Location`. Only `ACCEPT` was captured; in a live check (2026-11-09) `TENTATIVE`, `DECLINE` and `ACCEPT` each replaced the answer before them.\n\nSending the same answer twice changes nothing: the second call answers `201` with an identical body, including `lastModifiedAt`. There is no call to remove an answer in the capture.\n\n⚠️ **Others see it.** The school sees your name and answer, and it may decide what is arranged. The Parro app does not show parents who answered what, but `GET` on this path returns it to a parent's login.\n\n**Not known** (finding out means answering real invitations): the answer for a past or cancelled item or one with `rsvpRequired: false`, and whether teachers get a notification.",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppVersion"
          },
          {
            "$ref": "#/components/parameters/Role"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "The calendar item's **own** id (`calendarItem.links[rel=self].id`), not the event id: the event id answers `404`."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/vnd.topicus.geon+json;version=224": {
              "schema": {
                "type": "object",
                "required": [
                  "items"
                ],
                "properties": {
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "dtype",
                        "links",
                        "rsvp"
                      ],
                      "description": "The web app sends exactly these three fields.",
                      "properties": {
                        "dtype": {
                          "type": "string",
                          "enum": [
                            "calendar.RCalendarItemRSVPPrimer"
                          ]
                        },
                        "links": {
                          "type": "array",
                          "maxItems": 0,
                          "items": {},
                          "description": "Empty: the answer has no id yet."
                        },
                        "rsvp": {
                          "type": "string",
                          "enum": [
                            "ACCEPT",
                            "DECLINE",
                            "TENTATIVE"
                          ],
                          "description": "Your answer."
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Stored. One item: your answer.",
            "headers": {
              "Location": {
                "description": "`…/calendaritemrsvp/{rsvpId}` of the answer.",
                "schema": {
                  "type": "string",
                  "format": "uri"
                }
              }
            },
            "content": {
              "application/vnd.topicus.geon+json;version=224": {
                "schema": {
                  "type": "object",
                  "required": [
                    "items"
                  ],
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CalendarItemRSVPPrimer"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "default": {
            "$ref": "#/components/responses/GeonErrorResponse"
          }
        }
      }
    },
    "/oauth2/authorize": {
      "servers": [
        {
          "url": "https://inloggen.parnassys.net/idp",
          "description": "ParnasSys IdP"
        }
      ],
      "get": {
        "tags": [
          "Auth"
        ],
        "operationId": "authorize",
        "security": [],
        "summary": "Start a browser login (authorization code + PKCE)",
        "parameters": [
          {
            "name": "client_id",
            "in": "query",
            "required": true,
            "schema": {
              "example": "MQygAaSBUcAgPU2WInKt",
              "type": "string"
            },
            "description": "Public client of talk.parro.com."
          },
          {
            "name": "response_type",
            "in": "query",
            "required": true,
            "schema": {
              "enum": [
                "code"
              ],
              "type": "string"
            },
            "description": ""
          },
          {
            "name": "redirect_uri",
            "in": "query",
            "required": true,
            "schema": {
              "format": "uri",
              "example": "https://talk.parro.com/oauth2",
              "type": "string"
            },
            "description": "Must be exactly the registered URI; loopback URIs are rejected (`invalid_client`)."
          },
          {
            "name": "scope",
            "in": "query",
            "required": true,
            "schema": {
              "example": "openid offline_access",
              "type": "string"
            },
            "description": "`openid`; `offline_access` is granted but does not lengthen the 8-hour login."
          },
          {
            "name": "state",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Random value, echoed back."
          },
          {
            "name": "code_challenge",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "base64url(SHA-256(code_verifier))."
          },
          {
            "name": "code_challenge_method",
            "in": "query",
            "required": true,
            "schema": {
              "enum": [
                "S256",
                "plain"
              ],
              "type": "string"
            },
            "description": "Use `S256`."
          }
        ],
        "responses": {
          "200": {
            "description": "The ParnasSys login page (HTML)."
          },
          "302": {
            "description": "After login: redirect to `redirect_uri?code=…&state=…`.",
            "headers": {
              "Location": {
                "schema": {
                  "format": "uri",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request, e.g. `invalid_client — Callback url does not match one of [registered]` for an unregistered `redirect_uri`."
          }
        }
      }
    },
    "/oauth2/token": {
      "servers": [
        {
          "url": "https://inloggen.parnassys.net/idp",
          "description": "ParnasSys IdP"
        }
      ],
      "post": {
        "tags": [
          "Auth"
        ],
        "operationId": "token",
        "security": [],
        "summary": "Obtain or refresh tokens",
        "description": "⚠️ **Not usable from Swagger UI.** Call it from a terminal or a client, and see the warning in the introduction.\n\n**Two request shapes.**\n\n* `authorization_code` and `refresh_token` send their parameters in the **query string** with an **empty body** and `Content-Type: application/x-www-form-urlencoded`, as the web client does.\n* `password` sends a normal form-encoded **body** (`grant_type, client_id, username, password, scope`).\n\nA wrong password answers `400 invalid_grant` and counts toward the account lockout. That same error also comes back for accounts the IdP will not put through the password grant. Clients then fall back to the HTML login form, once: `GET /oauth2/authorize` (PKCE, follow redirects, keep cookies) → POST `aanmelden=x&emailadres=…&wachtwoord=…` to the `signInForm` action without following the redirect → take `code` from `Location` → `authorization_code` exchange as above.",
        "parameters": [
          {
            "name": "grant_type",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "authorization_code",
                "refresh_token"
              ],
              "type": "string"
            },
            "description": "Query-string shape only."
          },
          {
            "name": "client_id",
            "in": "query",
            "required": false,
            "schema": {
              "example": "MQygAaSBUcAgPU2WInKt",
              "type": "string"
            },
            "description": ""
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "authorization_code: the code from the redirect."
          },
          {
            "name": "code_verifier",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "authorization_code: the PKCE verifier."
          },
          {
            "name": "redirect_uri",
            "in": "query",
            "required": false,
            "schema": {
              "format": "uri",
              "type": "string"
            },
            "description": "authorization_code: same value as in /authorize."
          },
          {
            "name": "refresh_token",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "refresh_token grant."
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "grant_type": {
                    "enum": [
                      "password"
                    ],
                    "type": "string"
                  },
                  "client_id": {
                    "type": "string"
                  },
                  "username": {
                    "type": "string"
                  },
                  "password": {
                    "format": "password",
                    "type": "string"
                  },
                  "scope": {
                    "example": "openid offline_access",
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tokens.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthTokenResponse"
                }
              }
            }
          },
          "400": {
            "description": "RFC 6749 §5.2 error, e.g. `invalid_grant`. Not sampled.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            }
          }
        }
      }
    },
    "/oauth2/revoke": {
      "servers": [
        {
          "url": "https://inloggen.parnassys.net/idp",
          "description": "ParnasSys IdP"
        }
      ],
      "post": {
        "tags": [
          "Auth"
        ],
        "operationId": "revoke",
        "security": [],
        "summary": "Revoke a refresh or access token (RFC 7009)",
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "token",
                  "client_id"
                ],
                "properties": {
                  "token": {
                    "type": "string"
                  },
                  "token_type_hint": {
                    "enum": [
                      "refresh_token",
                      "access_token"
                    ],
                    "type": "string"
                  },
                  "client_id": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Revoked (empty body)."
          },
          "400": {
            "description": "RFC 6749 error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthError"
                }
              }
            }
          }
        }
      }
    },
    "/oauth2/logout": {
      "servers": [
        {
          "url": "https://inloggen.parnassys.net/idp",
          "description": "ParnasSys IdP"
        }
      ],
      "get": {
        "tags": [
          "Auth"
        ],
        "operationId": "endSession",
        "security": [],
        "x-parro-verified": false,
        "summary": "OIDC RP-initiated logout (unverified)",
        "description": "Advertised as `end_session_endpoint` in the discovery document; never called. Parameters follow OpenID Connect RP-Initiated Logout 1.0.",
        "parameters": [
          {
            "name": "id_token_hint",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": ""
          },
          {
            "name": "post_logout_redirect_uri",
            "in": "query",
            "required": false,
            "schema": {
              "format": "uri",
              "type": "string"
            },
            "description": ""
          },
          {
            "name": "client_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": ""
          }
        ],
        "responses": {
          "200": {
            "description": "Logout page (unverified)."
          },
          "302": {
            "description": "Redirect after logout (unverified)."
          },
          "4XX": {
            "description": "Client error (unverified)."
          }
        }
      }
    },
    "/.well-known/openid-configuration": {
      "servers": [
        {
          "url": "https://inloggen.parnassys.net",
          "description": "IdP issuer"
        }
      ],
      "get": {
        "tags": [
          "Auth"
        ],
        "operationId": "discovery",
        "security": [],
        "summary": "OpenID Connect discovery document",
        "description": "Location follows OIDC Discovery from `issuer`. Note: it also advertises `introspection_endpoint`, which needs client authentication and is not described.",
        "responses": {
          "200": {
            "description": "Discovery document.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenIDConfiguration"
                }
              }
            }
          },
          "4XX": {
            "description": "Client error."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "Paste an access token. This is the only scheme usable from Swagger UI; \"Try it out\" works with it."
      },
      "parnassysOAuth": {
        "type": "oauth2",
        "description": "⚠️ **Documentation only: do not use it from Swagger UI.** The code flow cannot complete there, because the redirect URI is pinned to https://talk.parro.com/oauth2 and PKCE (S256) is required. The password flow is refused (`invalid_grant`) for some accounts, and each failed attempt can count toward the IdP's account lockout. Obtain a token outside the browser and use **bearerToken**.",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://inloggen.parnassys.net/idp/oauth2/authorize",
            "tokenUrl": "https://inloggen.parnassys.net/idp/oauth2/token",
            "scopes": {
              "openid": "OpenID Connect",
              "offline_access": "Granted; the refresh token still expires 8 hours after the login"
            }
          },
          "password": {
            "tokenUrl": "https://inloggen.parnassys.net/idp/oauth2/token",
            "scopes": {
              "openid": "OpenID Connect",
              "offline_access": "Granted; the refresh token still expires 8 hours after the login"
            }
          }
        }
      }
    },
    "parameters": {
      "AppVersion": {
        "name": "parro-app-version",
        "in": "header",
        "required": false,
        "schema": {
          "type": "string",
          "example": "web:2.27.0"
        },
        "description": "Client version. Every official client sends it; it is unknown whether the server enforces it."
      },
      "Role": {
        "name": "parro-authorization-role",
        "in": "header",
        "required": false,
        "schema": {
          "type": "string",
          "pattern": "^[A-Z]+:[0-9]+$",
          "example": "GUARDIAN:1000000000"
        },
        "description": "`<ACCOUNTTYPE>:<id>` derived from `GET /account/me`. The web client sends it on every call except `/account/me`."
      },
      "Range": {
        "name": "Range",
        "in": "header",
        "required": false,
        "schema": {
          "type": "string",
          "pattern": "^items=[0-9]+-[0-9]+$",
          "example": "items=0-49"
        },
        "description": "Zero-based, inclusive item range."
      },
      "RangeCount": {
        "name": "topicus-Range-Count",
        "in": "header",
        "required": false,
        "schema": {
          "type": "string",
          "enum": [
            "Exact"
          ]
        },
        "description": "Ask for an exact total in `Content-Range`."
      }
    },
    "headers": {
      "ContentRange": {
        "schema": {
          "type": "string",
          "pattern": "^items [0-9]+-[0-9]+/[0-9]+$",
          "example": "items 0-1/2"
        },
        "description": "Returned range and total."
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Missing, expired or invalid token. Empty body, no Content-Type. **Also returned for `GET /event/{id}?dtype=event.RAnnouncementEvent`.**"
      },
      "GeonErrorResponse": {
        "description": "Error.",
        "content": {
          "application/vnd.topicus.geon+json;version=224": {
            "schema": {
              "$ref": "#/components/schemas/GeonError"
            }
          }
        }
      }
    },
    "schemas": {
      "Account": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "auth.RAccount"
            ],
            "example": "auth.RAccount",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "username": {
            "type": "string"
          },
          "externalUsername": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "organisation": {
            "$ref": "#/components/schemas/OrganisationPrimer"
          },
          "lastAccountSynchronize": {
            "type": "string",
            "format": "date-time"
          },
          "accountType": {
            "type": "string",
            "description": "Observed values: `GUARDIAN`. Not a closed list."
          },
          "identity": {
            "$ref": "#/components/schemas/Identity"
          },
          "avgId": {
            "type": "string"
          },
          "capabilities": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          },
          "accountPermissions": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          },
          "portalAccess": {
            "type": "boolean"
          },
          "state": {
            "type": "string",
            "description": "Observed values: `ACTIVE`. Not a closed list."
          },
          "numberOfExternalIdentities": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfActiveExternalIdentities": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `auth.RAccount`. Inferred from 1 object(s) in: `getAccountMe.200.json`."
      },
      "AccountSettings": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "auth.RAccountSettings"
            ],
            "example": "auth.RAccountSettings",
            "description": "Geon type discriminator."
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "email": {
            "type": "string"
          },
          "username": {
            "type": "string"
          },
          "digestPreference": {
            "type": "string",
            "description": "Observed values: `DAILY`. Not a closed list."
          },
          "translationPreference": {
            "$ref": "#/components/schemas/TranslationPreferenceSettings"
          },
          "digestHour": {
            "type": "integer",
            "format": "int32"
          },
          "active": {
            "type": "boolean"
          },
          "chatPreference": {
            "$ref": "#/components/schemas/ChatPreference"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `auth.RAccountSettings`. Inferred from 1 object(s) in: `getAccountSettings.200.json`."
      },
      "AnnouncementAttachment": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "attachment.RAnnouncementAttachment"
            ],
            "example": "attachment.RAnnouncementAttachment",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "attachmentType": {
            "type": "string",
            "description": "Observed values: `PDF`. Not a closed list."
          },
          "uploadId": {
            "type": "string"
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AttachmentDocumentEntry"
            }
          },
          "index": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `attachment.RAnnouncementAttachment`. Inferred from 4 object(s) in: `getEventAttachment.200.json`, `getEvent_announcement.200.json`, `getEvent_richtext.200.json`, `listEvents_announcements.200.json`."
      },
      "AnnouncementEventPreview": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "event.RAnnouncementEventPreview"
            ],
            "example": "event.RAnnouncementEventPreview",
            "description": "Geon type discriminator."
          },
          "title": {
            "type": "string"
          },
          "date": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `event.RAnnouncementEventPreview`. Inferred from 3 object(s) in: `listGroups.200.json`."
      },
      "AnnouncementEventPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "event.RAnnouncementEventPrimer"
            ],
            "example": "event.RAnnouncementEventPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "sortDate": {
            "type": "string",
            "format": "date-time"
          },
          "deleted": {
            "type": "boolean"
          },
          "read": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "cancelled": {
            "type": "boolean"
          },
          "liked": {
            "type": "boolean"
          },
          "realisationReason": {
            "type": "string",
            "description": "Observed values: `RECIPIENT`. Not a closed list."
          },
          "readCount": {
            "$ref": "#/components/schemas/EventReadCount"
          },
          "title": {
            "type": "string"
          },
          "contents": {
            "type": "string"
          },
          "likeable": {
            "type": "boolean"
          },
          "attachments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AnnouncementAttachment"
            }
          },
          "owner": {
            "$ref": "#/components/schemas/IdentityPrimer"
          },
          "lastEditedBy": {
            "$ref": "#/components/schemas/IdentityPrimer"
          },
          "draft": {
            "type": "boolean"
          },
          "pinned": {
            "type": "boolean"
          },
          "richTextContents": {
            "type": "string"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `event.RAnnouncementEventPrimer`. Inferred from 4 object(s) in: `getEvent_announcement.200.json`, `getEvent_richtext.200.json`, `listEvents_announcements.200.json`."
      },
      "AttachmentDocumentEntry": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "attachment.RAttachmentDocumentEntry"
            ],
            "example": "attachment.RAttachmentDocumentEntry",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "type": {
            "type": "string",
            "description": "Observed values: `SOURCE`, `VIDEO`. Not a closed list."
          },
          "url": {
            "type": "string"
          },
          "size": {
            "type": "integer",
            "format": "int64"
          },
          "contentType": {
            "type": "string"
          },
          "filename": {
            "type": "string"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `attachment.RAttachmentDocumentEntry`. Inferred from 10 object(s) in: `getChatMessage_video.200.json`, `getEventAttachment.200.json`, `getEvent_announcement.200.json`, `getEvent_attachment.200.json`, `getEvent_richtext.200.json`, `listChatMessages_media.200.json`, `listEvents_announcements.200.json`."
      },
      "AttachmentImageEntry": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "attachment.RAttachmentImageEntry"
            ],
            "example": "attachment.RAttachmentImageEntry",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "type": {
            "type": "string",
            "description": "Observed values: `THUMBNAIL`, `SOURCE`. Not a closed list."
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "size": {
            "type": "integer",
            "format": "int64"
          },
          "contentType": {
            "type": "string"
          },
          "height": {
            "type": "integer",
            "format": "int32"
          },
          "width": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `attachment.RAttachmentImageEntry`. Inferred from 5 object(s) in: `getChatMessage_video.200.json`, `getEvent_attachment.200.json`, `listChatMessages_media.200.json`."
      },
      "Avatar": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RAvatar"
            ],
            "example": "identity.RAvatar",
            "description": "Geon type discriminator."
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "roleId": {
            "type": "integer",
            "format": "int64"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "cachedAvatarUrl": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RAvatar`. Inferred from 8 object(s) in: `getEvent.200.json`, `getEvent_attachment.200.json`, `getEvent_link.200.json`, `listEvents_calendar-items.200.json`, `listGroups.200.json`."
      },
      "CalendarItem": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "calendar.RCalendarItem"
            ],
            "example": "calendar.RCalendarItem",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "type": {
            "type": "string",
            "description": "Observed values: `VOLUNTEER`, `SCHOOLWIDE_ACTIVITY`. Not a closed list."
          },
          "title": {
            "type": "string"
          },
          "rsvpRequired": {
            "type": "boolean"
          },
          "startDate": {
            "type": "string",
            "format": "date-time"
          },
          "endDate": {
            "type": "string",
            "format": "date-time"
          },
          "dayDates": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "date-time"
            }
          },
          "imported": {
            "type": "boolean"
          },
          "status": {
            "type": "string",
            "description": "Observed values: `OPEN`. Not a closed list."
          },
          "description": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "pending": {
            "type": "boolean"
          },
          "owner": {
            "$ref": "#/components/schemas/TeacherPrimer"
          },
          "numberOfResources": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfTimeslots": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfOpenTimeslots": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfUncommittedChildren": {
            "type": "integer",
            "format": "int32"
          },
          "timeslotInterval": {
            "type": "integer",
            "format": "int32"
          },
          "slack": {
            "type": "integer",
            "format": "int32"
          },
          "reminderInterval": {
            "type": "integer",
            "format": "int32"
          },
          "totalRespondents": {
            "type": "integer",
            "format": "int32"
          },
          "resources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CalendarItemVolunteerResource"
            }
          },
          "respondents": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          },
          "attachments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CalendarItemAttachment"
            }
          },
          "lastEditedBy": {
            "$ref": "#/components/schemas/TeacherPrimer"
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `calendar.RCalendarItem`. Inferred from 4 object(s) in: `getCalendarItem.200.json`, `getEvent.200.json`, `getEvent_attachment.200.json`, `getEvent_link.200.json`."
      },
      "CalendarItemAttachment": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "attachment.RCalendarItemAttachment"
            ],
            "example": "attachment.RCalendarItemAttachment",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "attachmentType": {
            "type": "string",
            "description": "Observed values: `IMAGE`. Not a closed list."
          },
          "uploadId": {
            "type": "string"
          },
          "entries": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/AttachmentDocumentEntry"
                },
                {
                  "$ref": "#/components/schemas/AttachmentImageEntry"
                }
              ],
              "discriminator": {
                "propertyName": "dtype",
                "mapping": {
                  "attachment.RAttachmentDocumentEntry": "#/components/schemas/AttachmentDocumentEntry",
                  "attachment.RAttachmentImageEntry": "#/components/schemas/AttachmentImageEntry"
                }
              }
            }
          },
          "index": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `attachment.RCalendarItemAttachment`. Inferred from 1 object(s) in: `getEvent_attachment.200.json`."
      },
      "CalendarItemEvent": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "event.RCalendarItemEvent"
            ],
            "example": "event.RCalendarItemEvent",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "lastEditedAt": {
            "type": "string",
            "format": "date-time"
          },
          "sortDate": {
            "type": "string",
            "format": "date-time"
          },
          "deleted": {
            "type": "boolean"
          },
          "read": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "cancelled": {
            "type": "boolean"
          },
          "liked": {
            "type": "boolean"
          },
          "readCount": {
            "$ref": "#/components/schemas/EventReadCount"
          },
          "children": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CalendarItemEventChild"
            }
          },
          "contributed": {
            "type": "boolean"
          },
          "dayNumber": {
            "type": "integer",
            "format": "int32"
          },
          "groups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupPrimer"
            }
          },
          "numberOfDays": {
            "type": "integer",
            "format": "int32"
          },
          "progress": {
            "type": "integer",
            "format": "int32"
          },
          "calendarItem": {
            "$ref": "#/components/schemas/CalendarItem"
          },
          "recipients": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupRecipient"
            }
          },
          "rsvp": {
            "type": "string",
            "description": "Observed values: `ACCEPT`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `event.RCalendarItemEvent`. Inferred from 3 object(s) in: `getEvent.200.json`, `getEvent_attachment.200.json`, `getEvent_link.200.json`."
      },
      "CalendarItemEventChild": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "event.RCalendarItemEventChild"
            ],
            "example": "event.RCalendarItemEventChild",
            "description": "Geon type discriminator."
          },
          "child": {
            "$ref": "#/components/schemas/Avatar"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `event.RCalendarItemEventChild`. Inferred from 6 object(s) in: `getEvent.200.json`, `getEvent_attachment.200.json`, `getEvent_link.200.json`, `listEvents_calendar-items.200.json`."
      },
      "CalendarItemEventPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "event.RCalendarItemEventPrimer"
            ],
            "example": "event.RCalendarItemEventPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "sortDate": {
            "type": "string",
            "format": "date-time"
          },
          "deleted": {
            "type": "boolean"
          },
          "read": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "cancelled": {
            "type": "boolean"
          },
          "liked": {
            "type": "boolean"
          },
          "readCount": {
            "$ref": "#/components/schemas/EventReadCount"
          },
          "children": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CalendarItemEventChild"
            }
          },
          "contributed": {
            "type": "boolean"
          },
          "dayNumber": {
            "type": "integer",
            "format": "int32"
          },
          "groups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupPrimer"
            }
          },
          "numberOfDays": {
            "type": "integer",
            "format": "int32"
          },
          "calendarItem": {
            "$ref": "#/components/schemas/CalendarItemPrimer"
          },
          "rsvp": {
            "type": "string",
            "description": "Observed values: `ACCEPT`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `event.RCalendarItemEventPrimer`. Inferred from 1 object(s) in: `listEvents_calendar-items.200.json`."
      },
      "CalendarItemPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "calendar.RCalendarItemPrimer"
            ],
            "example": "calendar.RCalendarItemPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "type": {
            "type": "string",
            "description": "Observed values: `ACTIVITY`. Not a closed list."
          },
          "title": {
            "type": "string"
          },
          "rsvpRequired": {
            "type": "boolean"
          },
          "startDate": {
            "type": "string",
            "format": "date-time"
          },
          "endDate": {
            "type": "string",
            "format": "date-time"
          },
          "dayDates": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "date-time"
            }
          },
          "imported": {
            "type": "boolean"
          },
          "status": {
            "type": "string",
            "description": "Observed values: `OPEN`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `calendar.RCalendarItemPrimer`. Inferred from 1 object(s) in: `listEvents_calendar-items.200.json`."
      },
      "CalendarItemRSVPPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "calendar.RCalendarItemRSVPPrimer"
            ],
            "example": "calendar.RCalendarItemRSVPPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "guardian": {
            "$ref": "#/components/schemas/GuardianPrimer"
          },
          "rsvp": {
            "type": "string",
            "description": "Observed values: `ACCEPT`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `calendar.RCalendarItemRSVPPrimer`. Inferred from 1 object(s) in: `answerRsvp.201.json`."
      },
      "CalendarItemResourceCommitmentPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "calendar.RCalendarItemResourceCommitmentPrimer"
            ],
            "example": "calendar.RCalendarItemResourceCommitmentPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "identity": {
            "$ref": "#/components/schemas/IdentityPrimer"
          },
          "amount": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `calendar.RCalendarItemResourceCommitmentPrimer`. Inferred from 2 object(s) in: `addCommitment.201.json`, `listCommitments.200.json`."
      },
      "CalendarItemVolunteerResource": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "calendar.RCalendarItemVolunteerResource"
            ],
            "example": "calendar.RCalendarItemVolunteerResource",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "title": {
            "type": "string"
          },
          "amount": {
            "type": "integer",
            "format": "int32"
          },
          "amountCommitted": {
            "type": "integer",
            "format": "int32"
          },
          "commitedByMe": {
            "type": "integer",
            "format": "int32"
          },
          "type": {
            "type": "string",
            "description": "Observed values: `VOLUNTEER`. Not a closed list."
          },
          "commitments": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `calendar.RCalendarItemVolunteerResource`. Inferred from 3 object(s) in: `getCalendarItem.200.json`, `getEvent.200.json`, `getEvent_link.200.json`."
      },
      "ChatMessageAttachment": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "attachment.RChatMessageAttachment"
            ],
            "example": "attachment.RChatMessageAttachment",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "attachmentType": {
            "type": "string",
            "description": "Observed values: `VIDEO`, `IMAGE`, `DOCUMENT`. Not a closed list."
          },
          "uploadId": {
            "type": "string"
          },
          "entries": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/AttachmentDocumentEntry"
                },
                {
                  "$ref": "#/components/schemas/AttachmentImageEntry"
                }
              ],
              "discriminator": {
                "propertyName": "dtype",
                "mapping": {
                  "attachment.RAttachmentDocumentEntry": "#/components/schemas/AttachmentDocumentEntry",
                  "attachment.RAttachmentImageEntry": "#/components/schemas/AttachmentImageEntry"
                }
              }
            }
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `attachment.RChatMessageAttachment`. Inferred from 4 object(s) in: `getChatMessage_video.200.json`, `listChatMessages_media.200.json`."
      },
      "ChatPreference": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RChatPreference"
            ],
            "example": "identity.RChatPreference",
            "description": "Geon type discriminator."
          },
          "sendMessagesWithShiftEnter": {
            "type": "boolean"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RChatPreference`. Inferred from 1 object(s) in: `getAccountSettings.200.json`."
      },
      "ChatRoom": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "chat.RChatRoom"
            ],
            "example": "chat.RChatRoom",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "sortDate": {
            "type": "string",
            "format": "date-time"
          },
          "muted": {
            "type": "boolean"
          },
          "todo": {
            "type": "boolean"
          },
          "unreadCount": {
            "type": "integer",
            "format": "int32"
          },
          "admin": {
            "type": "boolean"
          },
          "active": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "type": {
            "type": "string",
            "description": "Observed values: `FAMILY`. Not a closed list."
          },
          "title": {
            "type": "string"
          },
          "avatar": {
            "type": "string",
            "description": "Observed values: `REDACTED`. Not a closed list."
          },
          "numberOfMembers": {
            "type": "integer",
            "format": "int32"
          },
          "hasGuardians": {
            "type": "boolean"
          },
          "memberNames": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "childNames": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "repliesEnabled": {
            "type": "boolean"
          },
          "dnd": {
            "type": "boolean"
          },
          "lastMessage": {
            "$ref": "#/components/schemas/ChatTextMessage"
          },
          "members": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChatRoomMember"
            }
          },
          "children": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChatRoomChildPrimer"
            }
          },
          "state": {
            "type": "string",
            "description": "Observed values: `ACTIVE`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `chat.RChatRoom`. Inferred from 1 object(s) in: `getChatroom.200.json`."
      },
      "ChatRoomChildPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "chat.RChatRoomChildPrimer"
            ],
            "example": "chat.RChatRoomChildPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "cachedAvatarUrl": {
            "type": "string",
            "description": "Observed values: `REDACTED`. Not a closed list."
          },
          "role": {
            "type": "string",
            "description": "Observed values: `CHILD`. Not a closed list."
          },
          "archived": {
            "type": "boolean"
          },
          "enrolledSince": {
            "type": "string",
            "format": "date"
          },
          "numberOfGuardians": {
            "type": "integer",
            "format": "int32"
          },
          "guardianNames": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `chat.RChatRoomChildPrimer`. Inferred from 1 object(s) in: `getChatroom.200.json`."
      },
      "ChatRoomMember": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "chat.RChatRoomMember"
            ],
            "example": "chat.RChatRoomMember",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "sortDate": {
            "type": "string",
            "format": "date-time"
          },
          "muted": {
            "type": "boolean"
          },
          "todo": {
            "type": "boolean"
          },
          "unreadCount": {
            "type": "integer",
            "format": "int32"
          },
          "admin": {
            "type": "boolean"
          },
          "active": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "memberLastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "guardian": {
            "$ref": "#/components/schemas/GuardianPrimer"
          },
          "teacher": {
            "$ref": "#/components/schemas/Teacher"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `chat.RChatRoomMember`. Inferred from 8 object(s) in: `getChatroom.200.json`, `listChatroomMembers.200.json`."
      },
      "ChatRoomPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "chat.RChatRoomPrimer"
            ],
            "example": "chat.RChatRoomPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "sortDate": {
            "type": "string",
            "format": "date-time"
          },
          "muted": {
            "type": "boolean"
          },
          "todo": {
            "type": "boolean"
          },
          "unreadCount": {
            "type": "integer",
            "format": "int32"
          },
          "admin": {
            "type": "boolean"
          },
          "active": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "type": {
            "type": "string",
            "description": "Observed values: `CALENDAR`, `GROUP`, `SINGLE`, `FAMILY`. Not a closed list."
          },
          "title": {
            "type": "string"
          },
          "numberOfMembers": {
            "type": "integer",
            "format": "int32"
          },
          "hasGuardians": {
            "type": "boolean"
          },
          "memberNames": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "childNames": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "repliesEnabled": {
            "type": "boolean"
          },
          "dnd": {
            "type": "boolean"
          },
          "lastMessage": {
            "$ref": "#/components/schemas/ChatTextMessage"
          },
          "avatar": {
            "type": "string",
            "description": "Observed values: `REDACTED`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `chat.RChatRoomPrimer`. Inferred from 33 object(s) in: `listChatrooms.200.json`, `listChatrooms_archived.200.json`, `listChatrooms_schoolyear.200.json`, `listChatrooms_type-group.200.json`."
      },
      "ChatStatusMessage": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "chat.RChatStatusMessage"
            ],
            "example": "chat.RChatStatusMessage",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "identity": {
            "$ref": "#/components/schemas/IdentityPrimer"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "description": "Observed values: `ENTER`, `LEAVE`, `TITLE_CHANGED`. Not a closed list."
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `chat.RChatStatusMessage`. Inferred from 3 object(s) in: `listChatMessages_media.200.json`."
      },
      "ChatTextMessage": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "chat.RChatTextMessage"
            ],
            "example": "chat.RChatTextMessage",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "identity": {
            "$ref": "#/components/schemas/IdentityPrimer"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "deleted": {
            "type": "boolean"
          },
          "text": {
            "type": "string"
          },
          "allRead": {
            "type": "boolean"
          },
          "attachment": {
            "$ref": "#/components/schemas/ChatMessageAttachment"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `chat.RChatTextMessage`. Inferred from 38 object(s) in: `getChatMessage.200.json`, `getChatMessage_video.200.json`, `getChatroom.200.json`, `listChatMessages.200.json`, `listChatMessages_media.200.json`, `listChatrooms.200.json`, `listChatrooms_archived.200.json`, `listChatrooms_schoolyear.200.json`, `listChatrooms_type-group.200.json`, `sendChatMessage.201.json`."
      },
      "ChildPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RChildPrimer"
            ],
            "example": "identity.RChildPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "cachedAvatarUrl": {
            "type": "string",
            "format": "uri"
          },
          "role": {
            "type": "string",
            "description": "Observed values: `CHILD`. Not a closed list."
          },
          "archived": {
            "type": "boolean"
          },
          "enrolledSince": {
            "type": "string",
            "format": "date"
          },
          "numberOfGuardians": {
            "type": "integer",
            "format": "int32"
          },
          "guardianNames": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RChildPrimer`. Inferred from 2 object(s) in: `listChildren.200.json`."
      },
      "DoNotDisturbPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RDoNotDisturbPrimer"
            ],
            "example": "identity.RDoNotDisturbPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "scheme": {
            "type": "string",
            "description": "Observed values: `ALWAYS`. Not a closed list."
          },
          "mondayActive": {
            "type": "boolean"
          },
          "tuesdayActive": {
            "type": "boolean"
          },
          "wednesdayActive": {
            "type": "boolean"
          },
          "wednesdayStart": {
            "type": "string"
          },
          "wednesdayEnd": {
            "type": "string"
          },
          "thursdayActive": {
            "type": "boolean"
          },
          "thursdayStart": {
            "type": "string"
          },
          "thursdayEnd": {
            "type": "string"
          },
          "fridayActive": {
            "type": "boolean"
          },
          "fridayStart": {
            "type": "string"
          },
          "fridayEnd": {
            "type": "string"
          },
          "saturdayActive": {
            "type": "boolean"
          },
          "sundayActive": {
            "type": "boolean"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RDoNotDisturbPrimer`. Inferred from 2 object(s) in: `getChatroom.200.json`, `listChatroomMembers.200.json`."
      },
      "EventReadCount": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "event.REventReadCount"
            ],
            "example": "event.REventReadCount",
            "description": "Geon type discriminator."
          },
          "read": {
            "type": "integer",
            "format": "int32"
          },
          "total": {
            "type": "integer",
            "format": "int32"
          },
          "liked": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `event.REventReadCount`. Inferred from 8 object(s) in: `getEvent.200.json`, `getEvent_announcement.200.json`, `getEvent_attachment.200.json`, `getEvent_link.200.json`, `getEvent_richtext.200.json`, `listEvents_announcements.200.json`, `listEvents_calendar-items.200.json`."
      },
      "GeonError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "reason": {
            "type": "string"
          },
          "exception": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "applicationError": {
            "type": "string",
            "description": "Observed values: `EVENT_BAD_TYPE`. Not a closed list."
          },
          "errorDetails": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "description": "Geon error body, e.g. `406` with `applicationError: EVENT_BAD_TYPE` when `/event/{id}` is called without a usable `dtype`."
      },
      "GeonLink": {
        "type": "object",
        "required": [
          "rel"
        ],
        "properties": {
          "rel": {
            "type": "string",
            "example": "self"
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "example": 1000000000
          },
          "type": {
            "type": "string",
            "example": "identity.RChildPrimer"
          },
          "href": {
            "type": "string",
            "format": "uri",
            "example": "https://rest-v2.parro.com/rest/v2/child/1000000000"
          }
        }
      },
      "GeonObject": {
        "type": "object",
        "additionalProperties": true,
        "description": "The common geon envelope, used where the concrete type is unknown.",
        "properties": {
          "dtype": {
            "type": "string"
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "GeonPermission": {
        "type": "object",
        "properties": {
          "full": {
            "type": "string",
            "example": "attachment.RAttachment:READ:INSTANCE(11000000000)"
          },
          "type": {
            "type": "string",
            "example": "attachment.RAttachment"
          },
          "operations": {
            "type": "array",
            "items": {
              "type": "string",
              "example": "READ"
            }
          },
          "instances": {
            "type": "array",
            "items": {
              "type": "string",
              "example": "INSTANCE(11000000000)"
            }
          }
        }
      },
      "GroupPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RGroupPrimer"
            ],
            "example": "identity.RGroupPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "name": {
            "type": "string"
          },
          "schooljaar": {
            "type": "integer",
            "format": "int32"
          },
          "stamgroep": {
            "type": "boolean"
          },
          "type": {
            "type": "string",
            "description": "Observed values: `NORMAL`, `SCHOOLWIDE`, `COLLEAGUES`. Not a closed list."
          },
          "unreadCount": {
            "type": "integer",
            "format": "int32"
          },
          "memberMuted": {
            "type": "boolean"
          },
          "memberAbsenceNotificationsMuted": {
            "type": "boolean"
          },
          "numberOfChildren": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfGuardians": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfTeachers": {
            "type": "integer",
            "format": "int32"
          },
          "childAvatars": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RGroupPrimer`. Inferred from 20 object(s) in: `getEvent.200.json`, `getEvent_attachment.200.json`, `getEvent_link.200.json`, `listEvents_calendar-items.200.json`, `listGroups_previous.200.json`."
      },
      "GroupRecipient": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "event.RGroupRecipient"
            ],
            "example": "event.RGroupRecipient",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "group": {
            "$ref": "#/components/schemas/GroupPrimer"
          },
          "target": {
            "type": "string",
            "description": "Observed values: `GUARDIAN`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `event.RGroupRecipient`. Inferred from 5 object(s) in: `getEvent.200.json`, `getEvent_attachment.200.json`, `getEvent_link.200.json`."
      },
      "GuardianPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RGuardianPrimer"
            ],
            "example": "identity.RGuardianPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "description": "Observed values: `GUARDIAN`. Not a closed list."
          },
          "accountActive": {
            "type": "boolean"
          },
          "numberOfExternalIdentities": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfActiveExternalIdentities": {
            "type": "integer",
            "format": "int32"
          },
          "childNames": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "cachedAvatarUrl": {
            "type": "string",
            "description": "Observed values: `REDACTED`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RGuardianPrimer`. Inferred from 8 object(s) in: `answerRsvp.201.json`, `getAccountMe.200.json`, `getChatroom.200.json`, `getIdentity.200.json`, `getUnreadCounts.200.json`, `listChatroomMembers.200.json`."
      },
      "HomeGroup": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RHomeGroup"
            ],
            "example": "identity.RHomeGroup",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "name": {
            "type": "string"
          },
          "schooljaar": {
            "type": "integer",
            "format": "int32"
          },
          "stamgroep": {
            "type": "boolean"
          },
          "type": {
            "type": "string",
            "description": "Observed values: `SCHOOLWIDE`, `NORMAL`. Not a closed list."
          },
          "unreadCount": {
            "type": "integer",
            "format": "int32"
          },
          "memberMuted": {
            "type": "boolean"
          },
          "memberAbsenceNotificationsMuted": {
            "type": "boolean"
          },
          "numberOfChildren": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfGuardians": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfTeachers": {
            "type": "integer",
            "format": "int32"
          },
          "childAvatars": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Avatar"
            }
          },
          "lastAnnouncement": {
            "$ref": "#/components/schemas/AnnouncementEventPreview"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RHomeGroup`. Inferred from 3 object(s) in: `listGroups.200.json`."
      },
      "Identity": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RIdentity"
            ],
            "example": "identity.RIdentity",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "description": "Observed values: `GUARDIAN`. Not a closed list."
          },
          "email": {
            "type": "string"
          },
          "guardians": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GuardianPrimer"
            }
          },
          "children": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          },
          "teachers": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RIdentity`. Inferred from 2 object(s) in: `getAccountMe.200.json`, `getIdentity.200.json`."
      },
      "IdentityPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RIdentityPrimer"
            ],
            "example": "identity.RIdentityPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "description": "Observed values: `GUARDIAN`, `TEACHER`. Not a closed list."
          },
          "cachedAvatarUrl": {
            "type": "string"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RIdentityPrimer`. Inferred from 51 object(s) in: `addCommitment.201.json`, `getChatMessage.200.json`, `getChatMessage_video.200.json`, `getChatroom.200.json`, `getEvent_announcement.200.json`, `getEvent_richtext.200.json`, `listChatMessages.200.json`, `listChatMessages_media.200.json`, `listChatrooms.200.json`, `listChatrooms_archived.200.json`, `listChatrooms_schoolyear.200.json`, `listChatrooms_type-group.200.json`, `listCommitments.200.json`, `listEvents_announcements.200.json`, `sendChatMessage.201.json`."
      },
      "MediaExportSettings": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "mediaexport.RMediaExportSettings"
            ],
            "example": "mediaexport.RMediaExportSettings",
            "description": "Geon type discriminator."
          },
          "downloadEnabled": {
            "type": "boolean"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `mediaexport.RMediaExportSettings`. Inferred from 1 object(s) in: `getMediaExportSettings.200.json`."
      },
      "OAuthError": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "example": "invalid_grant"
          },
          "error_description": {
            "type": "string"
          }
        },
        "description": "RFC 6749 §5.2. Not sampled; modelled on the standard (`error`, `error_description`)."
      },
      "OAuthTokenResponse": {
        "type": "object",
        "properties": {
          "access_token": {
            "type": "string",
            "description": "Observed values: `REDACTED`. Not a closed list."
          },
          "refresh_token": {
            "type": "string",
            "description": "Observed values: `REDACTED`. Not a closed list."
          },
          "scope": {
            "type": "string"
          },
          "id_token": {
            "type": "string",
            "description": "Observed values: `REDACTED`. Not a closed list."
          },
          "token_type": {
            "type": "string"
          },
          "expires_in": {
            "type": "integer",
            "format": "int32"
          }
        },
        "description": "RFC 6749 §5.1 token response (sample values redacted)."
      },
      "OpenIDConfiguration": {
        "type": "object",
        "properties": {
          "authorization_endpoint": {
            "type": "string",
            "format": "uri"
          },
          "token_endpoint": {
            "type": "string",
            "format": "uri"
          },
          "introspection_endpoint": {
            "type": "string",
            "format": "uri"
          },
          "revocation_endpoint": {
            "type": "string",
            "format": "uri"
          },
          "issuer": {
            "type": "string",
            "format": "uri"
          },
          "jwks_uri": {
            "type": "string",
            "format": "uri"
          },
          "scopes_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "response_types_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "response_modes_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "grant_types_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "code_challenge_methods_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "token_endpoint_auth_methods_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "introspection_endpoint_auth_methods_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "revocation_endpoint_auth_methods_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "request_object_signing_alg_values_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ui_locales_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "request_parameter_supported": {
            "type": "boolean"
          },
          "request_uri_parameter_supported": {
            "type": "boolean"
          },
          "authorization_response_iss_parameter_supported": {
            "type": "boolean"
          },
          "subject_types_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "userinfo_endpoint": {
            "type": "string",
            "format": "uri"
          },
          "end_session_endpoint": {
            "type": "string",
            "format": "uri"
          },
          "id_token_signing_alg_values_supported": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Observed values: `RS256`. Not a closed list."
            }
          },
          "userinfo_signing_alg_values_supported": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Observed values: `RS256`. Not a closed list."
            }
          },
          "display_values_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "claim_types_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "claims_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "claims_parameter_supported": {
            "type": "boolean"
          }
        },
        "additionalProperties": true
      },
      "OrganisationPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "auth.ROrganisationPrimer"
            ],
            "example": "auth.ROrganisationPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "code": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "active": {
            "type": "boolean"
          },
          "system": {
            "type": "boolean"
          },
          "pricingPlan": {
            "type": "string",
            "description": "Observed values: `STANDARD`. Not a closed list."
          },
          "pricingPlanStartDate": {
            "type": "string",
            "format": "date"
          },
          "city": {
            "type": "string"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `auth.ROrganisationPrimer`. Inferred from 6 object(s) in: `getAccountMe.200.json`, `getChatroom.200.json`, `getOrganisation.200.json`, `listChatroomMembers.200.json`."
      },
      "PrivacyCentreSetting": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "privacy.RPrivacyCentreSetting"
            ],
            "example": "privacy.RPrivacyCentreSetting",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "editableForGuardians": {
            "type": "boolean"
          },
          "editableInPeriod": {
            "type": "boolean"
          },
          "lastEditedBy": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "description": "Observed values: `OPEN`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `privacy.RPrivacyCentreSetting`. Inferred from 2 object(s) in: `listChildren_privacy.200.json`."
      },
      "PrivacySettingChild": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RPrivacySettingChild"
            ],
            "example": "identity.RPrivacySettingChild",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "cachedAvatarUrl": {
            "type": "string",
            "format": "uri"
          },
          "role": {
            "type": "string",
            "description": "Observed values: `CHILD`. Not a closed list."
          },
          "archived": {
            "type": "boolean"
          },
          "enrolledSince": {
            "type": "string",
            "format": "date"
          },
          "numberOfGuardians": {
            "type": "integer",
            "format": "int32"
          },
          "guardianNames": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          },
          "setting": {
            "$ref": "#/components/schemas/PrivacyCentreSetting"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RPrivacySettingChild`. Inferred from 2 object(s) in: `listChildren_privacy.200.json`."
      },
      "PrivacySettings": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RPrivacySettings"
            ],
            "example": "identity.RPrivacySettings",
            "description": "Geon type discriminator."
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "defined": {
            "type": "boolean"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RPrivacySettings`. Inferred from 1 object(s) in: `getChildPrivacy.200.json`."
      },
      "Respondent": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RRespondent"
            ],
            "example": "identity.RRespondent",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "description": "Observed values: `TEACHER`, `GUARDIAN`. Not a closed list."
          },
          "rsvp": {
            "type": "string",
            "description": "Observed values: `ACCEPT`, `DECLINE`, `TENTATIVE`, `UNKNOWN`. Not a closed list."
          },
          "childNames": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "cachedAvatarUrl": {
            "type": "string",
            "description": "Observed values: `REDACTED`. Not a closed list."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RRespondent`. Inferred from 7 object(s) in: `listRsvpRespondents.200.json`."
      },
      "Schoolyear": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RSchoolyear"
            ],
            "example": "identity.RSchoolyear",
            "description": "Geon type discriminator."
          },
          "schoolyear": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RSchoolyear`. Inferred from 3 object(s) in: `listChatSchoolyears.200.json`."
      },
      "Strings": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "Strings"
            ],
            "example": "Strings",
            "description": "Geon type discriminator."
          },
          "strings": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `Strings`. Inferred from 1 object(s) in: `getCalendarSync.200.json`."
      },
      "SystemNewsEvent": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "systemnews.RSystemNewsEvent"
            ],
            "example": "systemnews.RSystemNewsEvent",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "scheduleDate": {
            "type": "string",
            "format": "date-time"
          },
          "title": {
            "type": "string"
          },
          "contents": {
            "type": "string"
          },
          "pricingPlanAudience": {
            "type": "string",
            "description": "Observed values: `STANDARD`. Not a closed list."
          },
          "audience": {
            "type": "string",
            "description": "Observed values: `GUARDIANS`, `EVERYONE`. Not a closed list."
          },
          "attachments": {
            "type": "array",
            "items": {},
            "description": "Always empty in the samples; item type unknown."
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `systemnews.RSystemNewsEvent`. Inferred from 6 object(s) in: `listSystemNews.200.json`."
      },
      "Teacher": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RTeacher"
            ],
            "example": "identity.RTeacher",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "description": "Observed values: `TEACHER`. Not a closed list."
          },
          "active": {
            "type": "boolean"
          },
          "accountActive": {
            "type": "boolean"
          },
          "organisation": {
            "$ref": "#/components/schemas/OrganisationPrimer"
          },
          "doNotDisturb": {
            "$ref": "#/components/schemas/DoNotDisturbPrimer"
          },
          "pricingPlan": {
            "type": "string",
            "description": "Observed values: `STANDARD`. Not a closed list."
          },
          "numberOfExternalIdentities": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfActiveExternalIdentities": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RTeacher`. Inferred from 4 object(s) in: `getChatroom.200.json`, `listChatroomMembers.200.json`."
      },
      "TeacherPrimer": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RTeacherPrimer"
            ],
            "example": "identity.RTeacherPrimer",
            "description": "Geon type discriminator."
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonLink"
            },
            "description": "Hypermedia links; the `rel: self` entry carries the object's id."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GeonPermission"
            },
            "description": "What the caller may do with this object."
          },
          "additionalObjects": {
            "type": "object",
            "additionalProperties": true,
            "description": "Side-loaded objects; empty in every sample."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time"
          },
          "firstname": {
            "type": "string"
          },
          "surname": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "description": "Observed values: `TEACHER`. Not a closed list."
          },
          "active": {
            "type": "boolean"
          },
          "accountActive": {
            "type": "boolean"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RTeacherPrimer`. Inferred from 7 object(s) in: `getCalendarItem.200.json`, `getEvent.200.json`, `getEvent_attachment.200.json`, `getEvent_link.200.json`."
      },
      "TranslationPreferenceSettings": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RTranslationPreferenceSettings"
            ],
            "example": "identity.RTranslationPreferenceSettings",
            "description": "Geon type discriminator."
          },
          "enabled": {
            "type": "string",
            "description": "Observed values: `DISABLED`. Not a closed list."
          },
          "preferredLanguage": {
            "type": "string"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RTranslationPreferenceSettings`. Inferred from 1 object(s) in: `getAccountSettings.200.json`."
      },
      "UnreadCount": {
        "type": "object",
        "properties": {
          "dtype": {
            "type": "string",
            "enum": [
              "identity.RUnreadCount"
            ],
            "example": "identity.RUnreadCount",
            "description": "Geon type discriminator."
          },
          "numberOfUnreadAnnouncements": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfUnreadCalendarItems": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfUnreadSystemNewsItems": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfUnreadChatRooms": {
            "type": "integer",
            "format": "int32"
          },
          "numberOfUnreadPortalNotifications": {
            "type": "integer",
            "format": "int32"
          },
          "guardian": {
            "$ref": "#/components/schemas/GuardianPrimer"
          }
        },
        "required": [
          "dtype"
        ],
        "description": "Geon type `identity.RUnreadCount`. Inferred from 1 object(s) in: `getUnreadCounts.200.json`."
      }
    }
  }
}
