Valori LogoValori
POST/v1/deleteREAD / WRITE

Delete a record

Hard-deletes a record by id, freeing its slot in the collection.

Frees the record's slot and unlinks it from its collection immediately — this is a hard delete, not a tombstone. Use Soft-delete a record instead if you want the record to stop appearing in search while keeping its audit history and slot reserved.

Request body

idintegerrequired

Id of the record to delete.

collectionstringoptional

Collection the record belongs to. Optional at the HTTP level (falls back to the node's default namespace) — pass it explicitly; every Cloud project starts with zero collections.

Response fields

successbooleanoptional

true on success.

log_indexintegeroptional

Raft log index of the committed delete. Present only in cluster mode.

The Python SDK's delete() returns None on success and raises on failure — it discards success/log_index rather than returning them. The TypeScript SDK's delete() returns the full response object above.

Errors

StatuscodeMeaning
400validation_errorMalformed request body.
401unauthorizedMissing or invalid API key.
403forbiddenThe key's scope doesn't include read_write.
404record_not_found, collection_not_foundThe record or collection doesn't exist.
500internal_errorCommit or audit-chain failure.

Related endpoints

POST /v1/delete
curl -X POST "https://app.valori.systems/v1/delete" \
  -H "Authorization: Bearer vlk_your_project_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "collection": "documents",
    "id": 42
  }'
200
{
  "success": true
}