"/admin/activity":
    post:
        tags: [Activities]
        operationId: createActivity
        summary: Create a shared activity (not implemented)
        description: |
            **Not implemented.** Handler currently throws — calls return
            a 500. Endpoint is registered to reserve the path; expect
            this to land later.
        deprecated: true
        requestBody:
            required: true
            content:
                application/json:
                    schema:
                        type: object
                        required: [type, ownerBigscreenAccountId]
                        properties:
                            type: { type: string, description: Activity type identifier. }
                            ownerBigscreenAccountId: { type: string }
                            roomId:
                                type: string
                                description: Bind the activity to a specific room (optional).
                            metaData:
                                type: object
                                additionalProperties: true
        responses:
            "500":
                description: Always — handler is a stub.
                content:
                    application/json:
                        schema: { $ref: "../cloud-admin-api.yaml#/components/schemas/Error" }
            "401": { $ref: "../cloud-admin-api.yaml#/components/responses/Unauthorized" }
            "403": { $ref: "../cloud-admin-api.yaml#/components/responses/Forbidden" }
        x-access-policies: [Moderator]

"/admin/activity/{activityId}":
    parameters:
        - in: path
          name: activityId
          required: true
          schema: { type: string }
    put:
        tags: [Activities]
        operationId: updateActivity
        summary: Update an activity (not implemented)
        description: |
            **Not implemented.** Handler currently throws — calls return
            a 500.
        deprecated: true
        requestBody:
            required: true
            content:
                application/json:
                    schema:
                        type: object
                        additionalProperties: true
        responses:
            "500":
                description: Always — handler is a stub.
                content:
                    application/json:
                        schema: { $ref: "../cloud-admin-api.yaml#/components/schemas/Error" }
            "401": { $ref: "../cloud-admin-api.yaml#/components/responses/Unauthorized" }
            "403": { $ref: "../cloud-admin-api.yaml#/components/responses/Forbidden" }
        x-access-policies: [Moderator]
    delete:
        tags: [Activities]
        operationId: deleteActivity
        summary: Delete an activity (not implemented)
        description: |
            **Not implemented.** Handler currently throws — calls return
            a 500.
        deprecated: true
        responses:
            "500":
                description: Always — handler is a stub.
                content:
                    application/json:
                        schema: { $ref: "../cloud-admin-api.yaml#/components/schemas/Error" }
            "401": { $ref: "../cloud-admin-api.yaml#/components/responses/Unauthorized" }
            "403": { $ref: "../cloud-admin-api.yaml#/components/responses/Forbidden" }
        x-access-policies: [Moderator]

"/admin/account/{bigscreenAccountId}/activity/{activityId}":
    parameters:
        - in: path
          name: bigscreenAccountId
          required: true
          schema: { type: string }
        - in: path
          name: activityId
          required: true
          schema: { type: string }
    get:
        tags: [Activities]
        operationId: getActivityForAccount
        summary: Fetch one activity owned by an account (not implemented)
        description: |
            **Not implemented.** Same `getActivities` handler as
            `/admin/account/{id}/activities` — currently throws and
            returns a 500.
        deprecated: true
        responses:
            "500":
                description: Always — handler is a stub.
                content:
                    application/json:
                        schema: { $ref: "../cloud-admin-api.yaml#/components/schemas/Error" }
            "401": { $ref: "../cloud-admin-api.yaml#/components/responses/Unauthorized" }
            "403": { $ref: "../cloud-admin-api.yaml#/components/responses/Forbidden" }
        x-access-policies: [Moderator]

"/admin/account/{bigscreenAccountId}/activities":
    parameters:
        - in: path
          name: bigscreenAccountId
          required: true
          schema: { type: string }
    get:
        tags: [Activities]
        operationId: getActivitiesForAccount
        summary: List activities for an account (not implemented)
        description: |
            **Not implemented.** Handler currently throws — calls return
            a 500.
        deprecated: true
        responses:
            "500":
                description: Always — handler is a stub.
                content:
                    application/json:
                        schema: { $ref: "../cloud-admin-api.yaml#/components/schemas/Error" }
            "401": { $ref: "../cloud-admin-api.yaml#/components/responses/Unauthorized" }
            "403": { $ref: "../cloud-admin-api.yaml#/components/responses/Forbidden" }
        x-access-policies: [Moderator]
