From 4416294c5cf2573d967676d0f593fda7cc384e23 Mon Sep 17 00:00:00 2001 From: Jacob Marble Date: Thu, 14 Dec 2023 10:29:50 -0800 Subject: [PATCH] chore: add note about partial write failures (#5275) * chore: add note about partial write failures Helps https://github.com/influxdata/influxdb_iox/issues/5226 * chore: integrate feedback Co-authored-by: Jason Stirnaman --------- Co-authored-by: Jason Stirnaman --- api-docs/cloud-serverless/ref.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-docs/cloud-serverless/ref.yml b/api-docs/cloud-serverless/ref.yml index d408ad857..2f575ee9c 100644 --- a/api-docs/cloud-serverless/ref.yml +++ b/api-docs/cloud-serverless/ref.yml @@ -14680,8 +14680,8 @@ tags: |  Code  | Status | Description | |:-----------:|:------------------------ |:--------------------- | | `200` | Success | | - | `201` | Created | Successfully created a resource. The response body may contain details. | - | `204` | No content | The request succeeded, but InfluxDB doesn't typically return a response body for the operation. | + | `201` | Created | Successfully created a resource. The response body may contain details. | + | `204` | No content | The request succeeded. For _writes_ that have [rejected points](/influxdb/cloud-serverless/write-data/troubleshoot/#troubleshoot-rejected-points), the [`/write` and `/api/v2/write` endpoints](#tag/Write) return a response body with error details. | | `400` | Bad request | InfluxDB can't parse the request due to an incorrect parameter or bad syntax. For _writes_, the error may indicate one of the following problems:
  • Line protocol is malformed. The response body contains the first malformed line in the data and indicates what was expected.
  • The batch contains a point with the same series as other points, but one of the field values has a different data type.
  • `Authorization` header is missing or malformed or the API token doesn't have permission for the operation.
| | `401` | Unauthorized | May indicate one of the following:
  • `Authorization: Token` header is missing or malformed
  • API token value is missing from the header
  • API token doesn't have permission. For more information about token types and permissions, see [Manage API tokens](/influxdb/cloud-serverless/security/tokens/)
| | `404` | Not found | Requested resource was not found. `message` in the response body provides details about the requested resource. |