TUturbopuffer

POST /v2/namespaces/{namespace}

Changed on

Create, update, or delete documents.

Request

Path parameters

namespacestring required

The name of the namespace.

Request body

upsert_conditionunknown
patch_conditionunknown
delete_conditionunknown
schemaobject

The schema of the attributes attached to the documents.

delete_by_filterunknown
delete_by_filter_allow_partialboolean

Allow partial completion when filter matches too many documents.

patch_by_filter_allow_partialboolean

Allow partial completion when filter matches too many documents.

return_affected_idsboolean

If true, return the IDs of affected rows (deleted, patched, upserted) in the response. For filtered and conditional writes, only IDs for writes that succeeded will be included.

disable_backpressureboolean

Disables write throttling (HTTP 429 responses) during high-volume ingestion.

create_namespaceboolean

If true, ensures the namespace is created, even if the request writes no documents. Creating an empty namespace requires the id type to be declared in schema. If false, a namespace is never created, and a 404 is returned if it does not exist. If omitted, a namespace is created by the first request that writes documents.

Response

The status of the request.

status'OK' required

The status of the request.

messagestring required

A message describing the result of the write request.

rows_affectedinteger required

The number of rows affected by the write request.

rows_upsertedinteger

The number of rows upserted by the write request.

rows_patchedinteger

The number of rows patched by the write request.

rows_deletedinteger

The number of rows deleted by the write request.

rows_remainingboolean

Whether more documents match the filter for partial operations.

Changes

  • 328394035cbaRevision changes
    • info

      added the new optional request property //

  • c99c9da22ed1Revision changes
    • warning

      the /////////// request property's min was set to 0.00

    • warning

      the /////////// request property's min was set to 0.00