Knowledge Sources - Delete File

Service:
Search Service
API Version:
2026-05-01-preview

Deletes a file from a File knowledge source and removes all indexed content derived from it.

DELETE {endpoint}/knowledgesources('{sourceName}')/files('{fileId}')?api-version=2026-05-01-preview

URI Parameters

Name In Required Type Description
endpoint
 path True

string (uri)

The endpoint URL of the search service.
fileId
 path True

string

The unique identifier of the file to delete.
sourceName
 path True

string

The name of the knowledge source.
api-version
 query True

string

minLength: 1

The API version to use for this operation.

Request Header

Name Required Type Description
Accept

Accept

The Accept header.
x-ms-client-request-id

string (uuid)

An opaque, globally-unique, client-generated string identifier for the request.

Responses

Name Type Description
204 No Content

There is no content to send for this request, but the headers may be useful.
404 Not Found

The server cannot find the requested resource.
Other Status Codes

ErrorResponse

An unexpected error response.

Security

api-key

Type: apiKey
In: header

OAuth2Auth

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Scopes

Name Description
https://search.azure.com/.default

Examples

SearchServiceDeleteKnowledgeSourceFile

Sample request

DELETE https://previewexampleservice.search.windows.net/knowledgesources('ks-file-test')/files('00000000-0000-0000-0000-000000000001')?api-version=2026-05-01-preview

Sample response

Status code:
404
Status code:
204

Definitions

Name Description
Accept

The Accept header.
ErrorAdditionalInfo

The resource management error additional info.
ErrorDetail

The error detail.
ErrorResponse

Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).

Accept

Enumeration

The Accept header.

Value Description
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Object

The resource management error additional info.

Name Type Description
info

searchservice.knowledgesources.deletefile

The additional info.
type

string

The additional info type.

ErrorDetail

Object

The error detail.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

The error additional info.
code

string

The error code.
details

ErrorDetail[]

The error details.
message

string

The error message.
target

string

The error target.

ErrorResponse

Object

Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).

Name Type Description
error

ErrorDetail

The error object.