ODR Search API v4

/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 | Parameter | Type | Required | Description | |---|---|---|---| | `record_uuid` | string (UUID) | āœ… Yes | The unique identifier of the record to delete. | --- ### Headers | Key | Value | Description | |---|---|---| | `Content-Type` | `application/json` | Specifies the request payload format. | | `Authorization` | `Bearer <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