operationId: deviceSignal
summary: Send Signal
security:
  - UserAuth: []
description: Send a signal to a device to control it
tags: [Device]
parameters:
  - name: home_id
    in: path
    description: ID of the home the device belongs to
    required: true
    schema:
      type: string
      format: uuid
      example: 019e1d64-6ad9-71e8-a976-ae99ad44c678
  - name: device_id
    in: path
    description: ID of the device
    required: true
    schema:
      type: string
      format: uuid
      example: 019e1d65-01ad-78b0-a70a-7200523c548f
requestBody:
  content:
    application/json:
      schema:
        type: object
        required:
          - device_type
          - signal
        properties:
          device_type:
            type: string
            description: Type of the device
            example: on_off_switch
            enum:
              - on_off_switch
          signal:
            description: Command to send (must match device_type)
            oneOf:
              - type: string
                description: on_off_switch
                enum:
                  - on
                  - off

responses:
  "200":
    description: "Signal success (always returns '{success: true}')"
    content:
      application/json:
        schema:
          type: object
          properties:
            success:
              type: boolean
  "400":
    $ref: "#/components/responses/400"
  "401":
    $ref: "#/components/responses/401"
  "403":
    $ref: "#/components/responses/403"
  "404":
    $ref: "#/components/responses/404"
  "500":
    $ref: "#/components/responses/500"