Merge remote-tracking branch 'origin/main' into api-update-glide-pr-29768

Author: chkn

api-reference/v2/resources/changelog.mdx

@@ -3,6 +3,10 @@ title: Glide API Changelog
 sidebarTitle: Changelog
 ---
 
+### September 18, 2024
+
+- Endpoints that receive tabular data can now accept CSV and TSV request bodies.
+
 ### September 13, 2024
 
 - Introduced a new "Limits" document that outlines rate and operational limits for the API.

api-reference/v2/stashing/put-stashes-serial.mdx

@@ -5,6 +5,8 @@ openapi: put /stashes/{stashID}/{serial}
 
 When using large datasets with the Glide API, it may be necessary to break them into smaller chunks for performance and reliability. We call this process "stashing."
 
+Tabular data may be stashed in JSON, CSV, or TSV format.
+
 <Tip>
   To learn more about stashing and how to use it to work with large datasets, please see our [introduction to stashing](/api-reference/v2/stashing/introduction).
 </Tip>

api-reference/v2/tables/post-table-rows.mdx

@@ -5,6 +5,8 @@ openapi: post /tables/{tableID}/rows
 
 Add row data to an existing Big Table.
 
+Row data may be passed in JSON, CSV, or TSV format.
+
 ## Examples
 
 <AccordionGroup>

api-reference/v2/tables/post-tables.mdx

@@ -5,6 +5,8 @@ openapi: post /tables
 
 Create a new Big Table, define its structure, and (optionally) populate it with data.
 
+When using a CSV or TSV request body, the name of the table must be passed as a query parameter and the schema of the table is inferred from the content. Alternatively, the CSV/TSV content may be [stashed](/api-reference/v2/stashing/introduction), and then the schema and name may be passed in the regular JSON payload.
+
 ## Examples
 
 <AccordionGroup>

api-reference/v2/tables/put-tables.mdx

@@ -5,6 +5,8 @@ openapi: put /tables/{tableID}
 
 Overwrite an existing Big Table by clearing all rows and adding new data. You can also update the table schema.
 
+When using a CSV or TSV request body, you cannot pass a schema. The current schema will be used. If you need to update the schema, use the `onSchemaError=updateSchema` query parameter, or [stash](/api-reference/v2/stashing/introduction) the CSV/TSV data and pass a JSON request body.
+
 <Warning>
 This is a destructive operation that cannot be undone.
 </Warning>

openapi/swagger.json

@@ -413,6 +413,20 @@
                 "example": "Name,Age,Birthday\nAlice,25,2024-08-29T09:46:16.722Z\nBob,30,2020-01-15T09:00:16.722Z"
               }
             },
+            "text/tab-separated-values": {
+              "schema": {
+                "type": "string",
+                "description": "A TSV string. The first line is column IDs, and each subsequent line is a row of data. The schema will be inferred from the data. The name of the table must be passed in the query parameter `name`.",
+                "example": "Name\tAge\tBirthday\nAlice\t25\t2024-08-29T09:46:16.722Z\nBob\t30\t2020-01-15T09:00:16.722Z"
+              }
+            },
+            "text/csv": {
+              "schema": {
+                "type": "string",
+                "description": "A CSV string. The first line is column IDs, and each subsequent line is a row of data. The schema will be inferred from the data. The name of the table must be passed in the query parameter `name`.",
+                "example": "Name,Age,Birthday\nAlice,25,2024-08-29T09:46:16.722Z\nBob,30,2020-01-15T09:00:16.722Z"
+              }
+            },
             "text/tab-separated-values": {
               "schema": {
                 "type": "string",
@@ -740,6 +754,20 @@
                 "example": "Name,Age,Birthday\nAlice,25,2024-08-29T09:46:16.722Z\nBob,30,2020-01-15T09:00:16.722Z"
               }
             },
+            "text/tab-separated-values": {
+              "schema": {
+                "type": "string",
+                "description": "A TSV string. The first line is column IDs, and each subsequent line is a row of data.",
+                "example": "Name\tAge\tBirthday\nAlice\t25\t2024-08-29T09:46:16.722Z\nBob\t30\t2020-01-15T09:00:16.722Z"
+              }
+            },
+            "text/csv": {
+              "schema": {
+                "type": "string",
+                "description": "A CSV string. The first line is column IDs, and each subsequent line is a row of data.",
+                "example": "Name,Age,Birthday\nAlice,25,2024-08-29T09:46:16.722Z\nBob,30,2020-01-15T09:00:16.722Z"
+              }
+            },
             "text/tab-separated-values": {
               "schema": {
                 "type": "string",