All Products
Search
Document Center

AI Coding Assistant Lingma:Delete a file

Last Updated:Jul 03, 2026

Permanently and irreversibly deletes a file by its ID.

Path parameters

Parameter Type Required Description
file_id string Yes The unique file identifier, prefixed with file_

Request headers

Header Required Description
Authorization Yes Bearer $QODER_PAT

Example request

curl -X DELETE "https://api.qoder.com.cn/api/v1/cloud/files/file_019e3bb8e4b67b7789e49ca6ecb2aae0" \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 204 No Content

A successful delete returns HTTP 204 with no response body.

Errors

HTTP Type Trigger
401 Missing or invalid authentication token
404 not_found_error File with the given ID does not exist

Error response example

{
  "error": {
    "message": "File 'file_nonexistent123' was not found.",
    "type": "not_found_error"
  },
  "type": "error"
}

Notes

  • Deletion is permanent and cannot be undone.
  • After deletion, the list endpoint no longer returns the file.
  • If the file is referenced by an active session, the reference becomes invalid after deletion.

See Errors for the full error envelope.