action britbox_generate_device_authorization_code {
  label: "generateDeviceAuthorizationCode"
  description: "Get a generated device authorization code.\n\nThis is the first step in the process of authorizing a device by pin code.\nThe device will make a request to this endpoint providing a unique identifier\nfor the device such as a serial number. This endpoint will then return a\ngenerated code which is tied to the given device.\n\nThe code may subsequently be used to authorize the device to sign in to an\naccount via the `/account/devices/authorization` endpoint. Typically this\nwill be from a page presented in the web app under the account section.\n\nOnce authorized, the device will then be able to sign in to that account\nvia the `/authorization/device` endpoint, without needing to provide the \ncredentials of the user.\n"
  provider: britbox
  method: POST
  path: "/authorization/device/code"
  encoding: json
  input: {
    type: "object"
    required: ["id", "name", "type"]
    properties: {
      id: {
        type: "string"
        description: "The unique identifier for this device e.g. serial number."
      }
      name: {
        type: "string"
        description: "A human recognisable name for this device."
      }
      type: {
        type: "string"
        description: "The device type e.g. web_browser."
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["code"]
    properties: {
      code: {
        type: "string"
        description: "The generated device authorization code."
      }
    }
    additionalProperties: false
  }
}