"/report/user":
    post:
        tags: [Reports]
        operationId: reportSocialProfile
        summary: Report a user
        description: |
            Files a report against another user. Mirrors the equivalent endpoint
            on the public auth API — both feed the same moderation queue.
        security:
            - cloudApiKey: []
              cloudAccessToken: []
        requestBody:
            required: true
            content:
                application/json:
                    schema:
                        type: object
                        required: [targetSocialId, reason]
                        properties:
                            targetSocialId: { type: string }
                            targetBigscreenAccountId: { type: string }
                            reason: { type: string }
                            roomId:
                                type: string
                                description: The room the incident took place in (when applicable).
                            details:
                                type: string
                                description: Reporter-supplied free text.
        responses:
            "200":
                description: Report filed.
                content:
                    application/json:
                        schema:
                            type: object
                            properties:
                                reportId: { type: string }
                                createdAt: { type: string, format: date-time }
            "401": { $ref: "../cloud-api.yaml#/components/responses/Unauthorized" }
            "404":
                description: Target user not found.
                content:
                    application/json:
                        schema: { $ref: "../cloud-api.yaml#/components/schemas/Error" }

"/report/room":
    post:
        tags: [Reports]
        operationId: reportRoom
        summary: Report a room
        security:
            - cloudApiKey: []
              cloudAccessToken: []
        requestBody:
            required: true
            content:
                application/json:
                    schema:
                        type: object
                        required: [roomId, reason]
                        properties:
                            roomId: { type: string }
                            reason: { type: string }
                            details: { type: string }
        responses:
            "200":
                description: Report filed.
                content:
                    application/json:
                        schema:
                            type: object
                            properties:
                                reportId: { type: string }
                                createdAt: { type: string, format: date-time }
            "401": { $ref: "../cloud-api.yaml#/components/responses/Unauthorized" }
            "404":
                description: No room with this id.
                content:
                    application/json:
                        schema: { $ref: "../cloud-api.yaml#/components/schemas/Error" }
