"/connection":
    get:
        tags: [Meta]
        operationId: checkConnectedUser
        summary: Connection probe
        description: |
            Returns whether the caller is connected and recognized by the cloud
            cluster. Used by VR clients on startup to verify the cluster knows
            about them before they try to join a room.
        security:
            - cloudApiKey: []
              cloudAccessToken: []
        responses:
            "200":
                description: Connection state.
                content:
                    application/json:
                        schema:
                            type: object
                            properties:
                                connected: { type: boolean }
                                userSessionId: { type: string }
                                bigscreenAccountId: { type: string }
                                serverId:
                                    type: string
                                    description: cloud_api instance the caller is talking to.
            "401": { $ref: "../cloud-api.yaml#/components/responses/Unauthorized" }
            "403": { $ref: "../cloud-api.yaml#/components/responses/Forbidden" }
            "429": { $ref: "../cloud-api.yaml#/components/responses/TooManyRequests" }
        x-access-policies: [BigscreenDefault]

"/schemas":
    get:
        tags: [Meta]
        operationId: getCloudPublicSchemas
        summary: Schema enumerations
        description: |
            Returns the room policy enums and other schema enumerations the VR
            client needs to render UIs (room visibility dropdowns, microphone
            policy, drawing visibility, etc.).
        security: []
        responses:
            "200":
                description: Schema enumerations.
                content:
                    application/json:
                        schema:
                            type: object
                            description: Each top-level key is an enum name; the value is the enum's member object.
                            additionalProperties:
                                type: object
                                additionalProperties: true
