Merge pull request #4490 from github/openapi-update-f7d48b7939131bda0…

…8c0d11de60e517f7945fbb06a9d8f56f72adde4a3e15113 Update OpenAPI 3.1 Descriptions
github · Jan 31, 2025 · b5172cc · b5172cc
2 parents 648346e + f8b8074
commit b5172cc
Show file tree

Hide file tree

Showing 16 changed files with 96 additions and 72 deletions.
diff --git a/descriptions-next/api.github.com/api.github.jparrowsec.cn.2022-11-28.json b/descriptions-next/api.github.com/api.github.jparrowsec.cn.2022-11-28.json
@@ -306613,7 +306613,7 @@
       },
       "billing-usage-report-year": {
         "name": "year",
-        "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2024`. Default value is the current year.",
+        "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year.",
         "in": "query",
         "required": false,
         "schema": {
@@ -306622,7 +306622,7 @@
       },
       "billing-usage-report-month": {
         "name": "month",
-        "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`.",
+        "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the default `year` is used.",
         "in": "query",
         "required": false,
         "schema": {
@@ -306631,7 +306631,7 @@
       },
       "billing-usage-report-day": {
         "name": "day",
-        "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`.",
+        "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used.",
         "in": "query",
         "required": false,
         "schema": {
@@ -306640,7 +306640,7 @@
       },
       "billing-usage-report-hour": {
         "name": "hour",
-        "description": "If specified, only return results for a single hour. The value of `hour` is an integer between `0` and `23`.",
+        "description": "If specified, only return results for a single hour. The value of `hour` is an integer between `0` and `23`. If no `year`, `month`, or `day` is specified, the default `year`, `month`, and `day` are used.",
         "in": "query",
         "required": false,
         "schema": {