Delete an inference endpoint
- DELETE /_inference/{task_type}/{inference_id}
- DELETE /_inference/{inference_id}
This API requires the manage_inference cluster privilege (the built-in inference_admin role grants this privilege).
Path Parameters
-
task_typeTaskTypeoptional -
The task type
Leave it out to use
/_inference/{inference_id}. -
Values:
sparse_embeddingtext_embeddingrerankcompletionchat_completionembedding -
inference_idstring Idrequired -
The inference identifier.
Query Parameters
-
dry_runboolean · default: false When true, checks the semantic_text fields and inference processors that reference the endpoint and returns them in a list, but does not delete the endpoint.
-
forceboolean · default: false When true, the inference endpoint is forcefully deleted even if it is still being used by ingest processors or semantic text fields.
Response
application/json
-
acknowledgedbooleanrequired -
For a successful response, this value is always true. On failure, an exception is returned instead.
-
pipelinesstringrequired