Browse Platform API
Platform API

Delete log records

Copy

Use this endpoint to delete client log index records after logs expire, an investigation is complete, or your business requests cleanup. The endpoint deletes OpenIM's index record; file retention at the registered URL remains the responsibility of your storage service.

HTTP request

POST {API_ADDRESS}/third/logs/delete

Request example

curl --request POST "${API_ADDRESS}/third/logs/delete" \
  --header "Content-Type: application/json; charset=utf-8" \
  --header "operationID: ${OPERATION_ID}" \
  --header "token: ${ADMIN_TOKEN}" \
  --data-raw '{"logIDs": ["1234567890"]}'

Request body

ParameterRequiredTypeDescription
logIDsYesstring[]Non-empty list of log record IDs to delete.

Response

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": ""
}

errCode === 0 means that OpenIM completed the index deletion request. Verify and clean up the underlying files according to your own retention policy. See Error codes for error handling.