@mistralai/mistralai 1.9.19 → 1.10.0

package/docs/sdks/libraries/README.md

@@ -19,6 +19,7 @@ List all libraries that you have created or have been shared with you.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="libraries_list_v1" method="get" path="/v1/libraries" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -29,7 +30,6 @@ const mistral = new Mistral({
 async function run() {
   const result = await mistral.beta.libraries.list();
 
-  // Handle the result
   console.log(result);
 }
 
@@ -52,15 +52,12 @@ const mistral = new MistralCore({
 
 async function run() {
   const res = await betaLibrariesList(mistral);
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaLibrariesList failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -90,6 +87,7 @@ Create a new Library, you will be marked as the owner and only you will have the
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="libraries_create_v1" method="post" path="/v1/libraries" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -102,7 +100,6 @@ async function run() {
     name: "<value>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -127,15 +124,12 @@ async function run() {
   const res = await betaLibrariesCreate(mistral, {
     name: "<value>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaLibrariesCreate failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -167,6 +161,7 @@ Given a library id, details information about that Library.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="libraries_get_v1" method="get" path="/v1/libraries/{library_id}" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -176,10 +171,9 @@ const mistral = new Mistral({
 
 async function run() {
   const result = await mistral.beta.libraries.get({
-    libraryId: "b888f774-3e7c-4135-a18c-6b985523c4bc",
+    libraryId: "d0d23a1e-bfe5-45e7-b7bb-22a4ea78d47f",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -202,17 +196,14 @@ const mistral = new MistralCore({
 
 async function run() {
   const res = await betaLibrariesGet(mistral, {
-    libraryId: "b888f774-3e7c-4135-a18c-6b985523c4bc",
+    libraryId: "d0d23a1e-bfe5-45e7-b7bb-22a4ea78d47f",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaLibrariesGet failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -244,6 +235,7 @@ Given a library id, deletes it together with all documents that have been upload
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="libraries_delete_v1" method="delete" path="/v1/libraries/{library_id}" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -253,10 +245,9 @@ const mistral = new Mistral({
 
 async function run() {
   const result = await mistral.beta.libraries.delete({
-    libraryId: "8b6fe91a-a0b1-4b3e-ab7b-e83a32f2399e",
+    libraryId: "6cad0b6e-fd2e-4d11-a48b-21d30fb7c17a",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -279,17 +270,14 @@ const mistral = new MistralCore({
 
 async function run() {
   const res = await betaLibrariesDelete(mistral, {
-    libraryId: "8b6fe91a-a0b1-4b3e-ab7b-e83a32f2399e",
+    libraryId: "6cad0b6e-fd2e-4d11-a48b-21d30fb7c17a",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaLibrariesDelete failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -321,6 +309,7 @@ Given a library id, you can update the name and description.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="libraries_update_v1" method="put" path="/v1/libraries/{library_id}" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -330,11 +319,10 @@ const mistral = new Mistral({
 
 async function run() {
   const result = await mistral.beta.libraries.update({
-    libraryId: "d95fa7f0-e743-42ce-b47c-b60cc78135dd",
+    libraryId: "e01880c3-d0b5-4a29-8b1b-abdb8ce917e4",
     libraryInUpdate: {},
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -357,18 +345,15 @@ const mistral = new MistralCore({
 
 async function run() {
   const res = await betaLibrariesUpdate(mistral, {
-    libraryId: "d95fa7f0-e743-42ce-b47c-b60cc78135dd",
+    libraryId: "e01880c3-d0b5-4a29-8b1b-abdb8ce917e4",
     libraryInUpdate: {},
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaLibrariesUpdate failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();

package/docs/sdks/mistralagents/README.md

@@ -19,6 +19,7 @@ Create a new agent giving it instructions, tools, description. The agent is then
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="agents_api_v1_agents_create" method="post" path="/v1/agents" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -28,11 +29,10 @@ const mistral = new Mistral({
 
 async function run() {
   const result = await mistral.beta.agents.create({
-    model: "Fiesta",
+    model: "LeBaron",
     name: "<value>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -55,18 +55,15 @@ const mistral = new MistralCore({
 
 async function run() {
   const res = await betaAgentsCreate(mistral, {
-    model: "Fiesta",
+    model: "LeBaron",
     name: "<value>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaAgentsCreate failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -98,6 +95,7 @@ Retrieve a list of agent entities sorted by creation time.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="agents_api_v1_agents_list" method="get" path="/v1/agents" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -108,7 +106,6 @@ const mistral = new Mistral({
 async function run() {
   const result = await mistral.beta.agents.list({});
 
-  // Handle the result
   console.log(result);
 }
 
@@ -131,15 +128,12 @@ const mistral = new MistralCore({
 
 async function run() {
   const res = await betaAgentsList(mistral, {});
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaAgentsList failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -171,6 +165,7 @@ Given an agent retrieve an agent entity with its attributes.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="agents_api_v1_agents_get" method="get" path="/v1/agents/{agent_id}" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -183,7 +178,6 @@ async function run() {
     agentId: "<id>",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -208,15 +202,12 @@ async function run() {
   const res = await betaAgentsGet(mistral, {
     agentId: "<id>",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaAgentsGet failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -248,6 +239,7 @@ Update an agent attributes and create a new version.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="agents_api_v1_agents_update" method="patch" path="/v1/agents/{agent_id}" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -261,7 +253,6 @@ async function run() {
     agentUpdateRequest: {},
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -287,15 +278,12 @@ async function run() {
     agentId: "<id>",
     agentUpdateRequest: {},
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaAgentsUpdate failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -327,6 +315,7 @@ Switch the version of an agent.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="agents_api_v1_agents_update_version" method="patch" path="/v1/agents/{agent_id}/version" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -337,10 +326,9 @@ const mistral = new Mistral({
 async function run() {
   const result = await mistral.beta.agents.updateVersion({
     agentId: "<id>",
-    version: 193920,
+    version: 157995,
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -364,17 +352,14 @@ const mistral = new MistralCore({
 async function run() {
   const res = await betaAgentsUpdateVersion(mistral, {
     agentId: "<id>",
-    version: 193920,
+    version: 157995,
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("betaAgentsUpdateVersion failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();

package/docs/sdks/mistraljobs/README.md

@@ -16,6 +16,7 @@ Get a list of batch jobs for your organization and user.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="jobs_api_routes_batch_get_batch_jobs" method="get" path="/v1/batch/jobs" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -26,7 +27,6 @@ const mistral = new Mistral({
 async function run() {
   const result = await mistral.batch.jobs.list({});
 
-  // Handle the result
   console.log(result);
 }
 
@@ -49,15 +49,12 @@ const mistral = new MistralCore({
 
 async function run() {
   const res = await batchJobsList(mistral, {});
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("batchJobsList failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -88,6 +85,7 @@ Create a new batch job, it will be queued for processing.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="jobs_api_routes_batch_create_batch_job" method="post" path="/v1/batch/jobs" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -98,13 +96,11 @@ const mistral = new Mistral({
 async function run() {
   const result = await mistral.batch.jobs.create({
     inputFiles: [
-      "a621cf02-1cd9-4cf5-8403-315211a509a3",
+      "fe3343a2-3b8d-404b-ba32-a78dede2614a",
     ],
-    endpoint: "/v1/fim/completions",
-    model: "2",
+    endpoint: "/v1/classifications",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -128,20 +124,16 @@ const mistral = new MistralCore({
 async function run() {
   const res = await batchJobsCreate(mistral, {
     inputFiles: [
-      "a621cf02-1cd9-4cf5-8403-315211a509a3",
+      "fe3343a2-3b8d-404b-ba32-a78dede2614a",
     ],
-    endpoint: "/v1/fim/completions",
-    model: "2",
+    endpoint: "/v1/classifications",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("batchJobsCreate failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -172,6 +164,7 @@ Get a batch job details by its UUID.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="jobs_api_routes_batch_get_batch_job" method="get" path="/v1/batch/jobs/{job_id}" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -181,10 +174,9 @@ const mistral = new Mistral({
 
 async function run() {
   const result = await mistral.batch.jobs.get({
-    jobId: "b888f774-3e7c-4135-a18c-6b985523c4bc",
+    jobId: "4017dc9f-b629-42f4-9700-8c681b9e7f0f",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -207,17 +199,14 @@ const mistral = new MistralCore({
 
 async function run() {
   const res = await batchJobsGet(mistral, {
-    jobId: "b888f774-3e7c-4135-a18c-6b985523c4bc",
+    jobId: "4017dc9f-b629-42f4-9700-8c681b9e7f0f",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("batchJobsGet failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -248,6 +237,7 @@ Request the cancellation of a batch job.
 
 ### Example Usage
 
+<!-- UsageSnippet language="typescript" operationID="jobs_api_routes_batch_cancel_batch_job" method="post" path="/v1/batch/jobs/{job_id}/cancel" -->
 ```typescript
 import { Mistral } from "@mistralai/mistralai";
 
@@ -257,10 +247,9 @@ const mistral = new Mistral({
 
 async function run() {
   const result = await mistral.batch.jobs.cancel({
-    jobId: "0f713502-9233-41c6-9ebd-c570b7edb496",
+    jobId: "4fb29d1c-535b-4f0a-a1cb-2167f86da569",
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -283,17 +272,14 @@ const mistral = new MistralCore({
 
 async function run() {
   const res = await batchJobsCancel(mistral, {
-    jobId: "0f713502-9233-41c6-9ebd-c570b7edb496",
+    jobId: "4fb29d1c-535b-4f0a-a1cb-2167f86da569",
   });
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("batchJobsCancel failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();