From d7b3accfa0b3d3a3812e1357279cc0e3795f223b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Thu, 21 Mar 2024 15:17:58 +0100
Subject: [PATCH] [DOCS] Adjusts PUT inference API docs examples (#106604)
 (#106606)

Co-authored-by: David Kyle <david.kyle@elastic.co>
---
 .../inference/put-inference.asciidoc          | 24 ++++++++-----------
 1 file changed, 10 insertions(+), 14 deletions(-)

diff --git a/docs/reference/inference/put-inference.asciidoc b/docs/reference/inference/put-inference.asciidoc
index 1731a001b3b92..93dd0a961604b 100644
--- a/docs/reference/inference/put-inference.asciidoc
+++ b/docs/reference/inference/put-inference.asciidoc
@@ -162,6 +162,12 @@ creating the {infer} model, you cannot change the associated API key. If you
 want to use a different API key, delete the {infer} model and recreate it with
 the same name and the updated API key.
 
+`model_id`:::
+(Optional, string)
+The name of the model to use for the {infer} task. Refer to the
+https://platform.openai.com/docs/guides/embeddings/what-are-embeddings[OpenAI documentation]
+for the list of available text embedding models.
+
 `organization_id`:::
 (Optional, string)
 The unique identifier of your organization. You can find the Organization ID in
@@ -215,13 +221,6 @@ Valid values are:
   * `search`: use it for storing embeddings of search queries run against a
   vector data base to find relevant documents.
 
-`model`:::
-(Optional, string)
-For `openai` sevice only. The name of the model to use for the {infer} task. Refer
-to the
-https://platform.openai.com/docs/guides/embeddings/what-are-embeddings[OpenAI documentation]
-for the list of available text embedding models.
-
 `truncate`:::
 (Optional, string)
 For `cohere` service only. Specifies how the API handles inputs longer than the
@@ -256,7 +255,7 @@ PUT _inference/text_embedding/cohere-embeddings
     "service": "cohere",
     "service_settings": {
         "api_key": "<api_key>",
-        "model": "embed-english-light-v3.0",
+        "model_id": "embed-english-light-v3.0",
         "embedding_type": "byte"
     }
 }
@@ -304,8 +303,7 @@ PUT _inference/sparse_embedding/my-elser-model
   "service_settings": {
     "num_allocations": 1,
     "num_threads": 1
-  },
-  "task_settings": {}
+  }
 }
 ------------------------------------------------------------
 // TEST[skip:TBD]
@@ -397,10 +395,8 @@ PUT _inference/text_embedding/openai_embeddings
 {
     "service": "openai",
     "service_settings": {
-        "api_key": "<api_key>"
-    },
-    "task_settings": {
-       "model": "text-embedding-ada-002"
+        "api_key": "<api_key>",
+        "model_id": "text-embedding-ada-002"
     }
 }
 ------------------------------------------------------------