Skip to navigation

/record/{record_uuid}

View as Markdown

DELETE /record/{record_uuid}

Permanently deletes a dataset record identified by its UUID. The record is removed from the system and cannot be recovered. The caller must have the appropriate permissions to delete the target record.


HTTP Method & URL

DELETE {{url}}/record/{record_uuid}

Path Parameters

ParameterTypeRequiredDescription
record_uuidstring (UUID)✅ YesThe unique identifier of the record to delete.

Headers

KeyValueDescription
Content-Typeapplication/jsonSpecifies the request payload format.
AuthorizationBearer <token>Bearer token automatically set by the pre-request script (see Authentication below).

Authentication

Authentication is handled automatically via a pre-request script. Before the request is sent, the script performs the following:

  1. POSTs to {{url}}/token using the apiuser and apipass environment variables as credentials.
  2. Retrieves a Bearer token from the response.
  3. Sets the token as a variable so it is included in the Authorization header of this request.

Ensure the apiuser, apipass, and url environment variables are set in your active environment before sending this request.


Permissions

This endpoint enforces permission checks. The authenticated user must have sufficient privileges to delete the specified record. Attempting to delete a record without the required permissions will result in an error response. See the related request /record/{record_uuid} Invalid Permissions for an example of the error behavior when permissions are insufficient.


Response

A successful deletion will return an appropriate HTTP success status (e.g., 200 OK or 204 No Content). No record data is returned after deletion.

Response headers

:statusstringOptional
cache-controlstringOptional
access-control-allow-originstringOptional
access-control-allow-methodsstringOptional
access-control-allow-headersstringOptional
access-control-expose-headersstringOptional
access-control-max-agestringOptional

Response

OK
deletedlist of strings
countinteger

Errors

500
Internal Server Error