action collegefootballdata_get_player_usage {
  label: "Player usage metrics broken down by season"
  description: "Player usage metrics by season"
  provider: collegefootballdata
  method: GET
  path: "/player/usage"
  encoding: json
  input: {
    type: "object"
    properties: {
      conference: {
        type: "string"
      }
      excludeGarbageTime: {
        type: "boolean"
      }
      playerId: {
        type: "integer"
      }
      position: {
        type: "string"
      }
      team: {
        type: "string"
      }
      year: {
        type: "integer"
      }
    }
    required: ["year"]
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      properties: {
        conference: {
          type: "string"
        }
        id: {
          type: "integer"
        }
        name: {
          type: "string"
        }
        position: {
          type: "string"
        }
        season: {
          type: "integer"
        }
        team: {
          type: "string"
        }
        usage: {
          type: "object"
          properties: {
            firstDown: {
              type: "number"
            }
            overall: {
              type: "number"
            }
            pass: {
              type: "number"
            }
            passingDowns: {
              type: "number"
            }
            rush: {
              type: "number"
            }
            secondDown: {
              type: "number"
            }
            standardDowns: {
              type: "number"
            }
            thirdDown: {
              type: "number"
            }
          }
        }
      }
    }
  }
}