extractia-sdk 1.1.0 → 1.2.0

package/README.md

@@ -23,6 +23,7 @@ Works in Node.js ≥ 18 and modern browsers via the provided UMD build.
    - [Exports](#exports)
    - [OCR Tools](#ocr-tools)
    - [Credits & Analytics](#credits--analytics)
+   - [Sub-Users](#sub-users)
 6. [TypeScript](#typescript)
 7. [Rate Limits & Quotas](#rate-limits--quotas)
 8. [Changelog](#changelog)
@@ -56,13 +57,21 @@ pnpm add extractia-sdk
 ## Quick Start
 
 ```js
-import { setToken, suggestFields, createTemplate, processImage } from "extractia-sdk";
+import {
+  setToken,
+  suggestFields,
+  createTemplate,
+  processImage,
+} from "extractia-sdk";
 
 // 1. Authenticate
 setToken("ext_YOUR_API_TOKEN_HERE");
 
 // 2. Let AI suggest fields for your document type
-const fields = await suggestFields("Invoice", "header data plus all line items with product and quantity");
+const fields = await suggestFields(
+  "Invoice",
+  "header data plus all line items with product and quantity",
+);
 
 // 3. Create a template from the suggestions
 const template = await createTemplate({ label: "Invoice", fields });
@@ -175,9 +184,9 @@ Returns the profile and usage metrics of the authenticated user.
 
 ```js
 const profile = await getMyProfile();
-console.log(profile.email);             // 'user@example.com'
+console.log(profile.email); // 'user@example.com'
 console.log(profile.formTemplatesCount); // 5
-console.log(profile.documentsCount);    // 42
+console.log(profile.documentsCount); // 42
 ```
 
 ---
@@ -187,8 +196,8 @@ console.log(profile.documentsCount);    // 42
 Updates the webhook URL. After each successful extraction, Extractia
 sends a `POST` to this URL with the document payload.
 
-| Parameter | Type     | Required | Description                                  |
-| --------- | -------- | -------- | -------------------------------------------- |
+| Parameter | Type     | Required | Description                                    |
+| --------- | -------- | -------- | ---------------------------------------------- |
 | `url`     | `string` | ✅       | Webhook URL (pass empty string `""` to remove) |
 
 **Returns:** `Promise<void>`
@@ -257,10 +266,10 @@ Results can be passed directly to `createTemplate`.
 
 **Consumes AI credits.**
 
-| Parameter           | Type     | Required | Description                                                        |
-| ------------------- | -------- | -------- | ------------------------------------------------------------------ |
-| `templateName`      | `string` | ✅       | Document type name (e.g. `"Invoice"`, `"Driver's License"`)        |
-| `extractionContext` | `string` | —        | Natural-language hint about what to extract or detect              |
+| Parameter           | Type     | Required | Description                                                 |
+| ------------------- | -------- | -------- | ----------------------------------------------------------- |
+| `templateName`      | `string` | ✅       | Document type name (e.g. `"Invoice"`, `"Driver's License"`) |
+| `extractionContext` | `string` | —        | Natural-language hint about what to extract or detect       |
 
 ```js
 // Basic usage
@@ -269,18 +278,24 @@ const fields = await suggestFields("Receipt");
 // With context — AI will only return what you describe
 const fields = await suggestFields(
   "Purchase Order",
-  "I need the supplier name, PO number, and all ordered products with quantity and unit price"
+  "I need the supplier name, PO number, and all ordered products with quantity and unit price",
 );
 
 const template = await createTemplate({ label: "Purchase Order", fields });
 ```
 
 The returned array follows the `FormField` shape:
+
 ```json
 [
-  { "label": "PO Number",   "type": "TEXT",     "required": true },
-  { "label": "Supplier",    "type": "TEXT",     "required": true },
-  { "label": "Order Items", "type": "LIST",     "required": false, "listLabel": "Product" }
+  { "label": "PO Number", "type": "TEXT", "required": true },
+  { "label": "Supplier", "type": "TEXT", "required": true },
+  {
+    "label": "Order Items",
+    "type": "LIST",
+    "required": false,
+    "listLabel": "Product"
+  }
 ]
 ```
 
@@ -294,11 +309,16 @@ Creates a new template.
 const template = await createTemplate({
   label: "Purchase Order",
   fields: [
-    { label: "PO Number",    type: "TEXT",     required: true },
-    { label: "Vendor",       type: "TEXT",     required: true },
+    { label: "PO Number", type: "TEXT", required: true },
+    { label: "Vendor", type: "TEXT", required: true },
     { label: "Total Amount", type: "CURRENCY", required: true },
-    { label: "Order Date",   type: "DATE",     required: false },
-    { label: "Line Items",   type: "LIST",     required: false, listLabel: "Product" },
+    { label: "Order Date", type: "DATE", required: false },
+    {
+      label: "Line Items",
+      type: "LIST",
+      required: false,
+      listLabel: "Product",
+    },
   ],
 });
 console.log(template.id); // 'tpl_newid'
@@ -313,9 +333,9 @@ Updates an existing template's label and/or fields.
 ```js
 const updated = await updateTemplate("tpl_abc123", {
   fields: [
-    { label: "Vendor",     type: "TEXT",     required: true },
-    { label: "Total",      type: "CURRENCY", required: true },
-    { label: "Due Date",   type: "DATE",     required: false },
+    { label: "Vendor", type: "TEXT", required: true },
+    { label: "Total", type: "CURRENCY", required: true },
+    { label: "Due Date", type: "DATE", required: false },
   ],
 });
 ```
@@ -359,7 +379,7 @@ Returns a paginated list of documents for a given template (newest first by defa
 
 ```js
 const page = await getDocumentsByTemplateId("tpl_abc123", {
-  preconformed: false,  // only unreviewed
+  preconformed: false, // only unreviewed
   index: 0,
 });
 
@@ -376,12 +396,14 @@ for (const doc of page.content) {
 
 Returns a single document by template and document ID.
 
-| Option         | Type      | Default | Description                        |
-| -------------- | --------- | ------- | ---------------------------------- |
-| `includeImage` | `boolean` | `false` | Include the base64 source image    |
+| Option         | Type      | Default | Description                     |
+| -------------- | --------- | ------- | ------------------------------- |
+| `includeImage` | `boolean` | `false` | Include the base64 source image |
 
 ```js
-const doc = await getDocumentById("tpl_abc123", "doc_xyz789", { includeImage: true });
+const doc = await getDocumentById("tpl_abc123", "doc_xyz789", {
+  includeImage: true,
+});
 console.log(doc.imageBase64); // the original scan
 ```
 
@@ -393,7 +415,7 @@ Returns the N most-recent documents across **all templates**. Useful for dashboa
 
 ```js
 const recent = await getRecentDocuments(5);
-recent.forEach(doc => console.log(doc.createdAt, doc.formTemplateId));
+recent.forEach((doc) => console.log(doc.createdAt, doc.formTemplateId));
 ```
 
 ---
@@ -424,7 +446,10 @@ await updateDocumentStatus("doc_xyz789", "APPROVED");
 Saves reviewer annotations on a document. Pass `""` to clear.
 
 ```js
-await updateDocumentNotes("doc_xyz789", "Verified against original: amounts match.");
+await updateDocumentNotes(
+  "doc_xyz789",
+  "Verified against original: amounts match.",
+);
 await updateDocumentNotes("doc_xyz789", ""); // clear notes
 ```
 
@@ -435,16 +460,16 @@ await updateDocumentNotes("doc_xyz789", ""); // clear notes
 Corrects or overwrites the extracted field data programmatically. Optionally
 marks the document as preconformed (reviewed) in the same call.
 
-| Option          | Type      | Default | Description                              |
-| --------------- | --------- | ------- | ---------------------------------------- |
-| `preconformed`  | `boolean` | `false` | Mark document as reviewed/confirmed      |
+| Option         | Type      | Default | Description                         |
+| -------------- | --------- | ------- | ----------------------------------- |
+| `preconformed` | `boolean` | `false` | Mark document as reviewed/confirmed |
 
 ```js
 // Fix a wrong extraction and confirm
 await updateDocumentData(
   "doc_xyz789",
-  { "Total Amount": 1250.00, "Invoice Number": "INV-1042" },
-  { preconformed: true }
+  { "Total Amount": 1250.0, "Invoice Number": "INV-1042" },
+  { preconformed: true },
 );
 ```
 
@@ -548,9 +573,9 @@ Returns all extracted data as a UTF-8 CSV string with BOM (Excel-compatible).
 Each row is one document; columns are the extracted fields plus `preconformed`
 and `uploadedAt`.
 
-| Option    | Type       | Description                                       |
-| --------- | ---------- | ------------------------------------------------- |
-| `fields`  | `string[]` | Optional column subset. Dot-notation for nested.  |
+| Option   | Type       | Description                                      |
+| -------- | ---------- | ------------------------------------------------ |
+| `fields` | `string[]` | Optional column subset. Dot-notation for nested. |
 
 ```js
 // Export everything
@@ -570,13 +595,13 @@ const csv = await exportDocumentsCsv("tpl_abc123", {
 Returns all documents as a plain JSON array. Each element is the extracted
 field map plus three metadata keys:
 
-- `_id` — document ID  
-- `_preconformed` — whether the document was reviewed  
+- `_id` — document ID
+- `_preconformed` — whether the document was reviewed
 - `_uploadedAt` — ISO timestamp
 
 ```js
 const records = await exportDocumentsJson("tpl_abc123");
-records.forEach(doc => {
+records.forEach((doc) => {
   console.log(doc._id, doc["Invoice Number"], doc["Total Amount"]);
 });
 
@@ -592,13 +617,64 @@ writeFileSync("invoices.json", JSON.stringify(records, null, 2));
 OCR Tools let you ask AI yes/no questions, classify documents into labels, or
 extract free-form text from any image — without a template.
 
+> **Credit consumption:** every OCR Agent run deducts **1 document** from the user's monthly (or add-on) document quota **plus AI credits** based on the token count of the AI analysis (calculated as `ceil(totalTokens / 1000)` credits).
+
+#### Dynamic parameters (`{{?N}}` syntax)
+
+Prompts can include numbered placeholders of the form `{{?1}}`, `{{?2}}`, etc.  
+At run time you supply the actual values; the AI receives the substituted text.
+
+```js
+// Tool with two dynamic parameters
+const checker = await createOcrTool({
+  name: "Property Ownership Check",
+  prompt:
+    "Does this document appear to be a proof of ownership for the property at {{?1}} in the name of {{?2}}?",
+  outputType: "YES_NO",
+  parameterDefinitions: [
+    {
+      key: 1,
+      label: "Property address",
+      description: "Full street address",
+      maxChars: 200,
+    },
+    {
+      key: 2,
+      label: "Owner name",
+      description: "Full legal name of the owner",
+      maxChars: 150,
+    },
+  ],
+});
+
+// Run with values
+const result = await runOcrTool(checker.id, imageBase64, {
+  params: { 1: "123 Main St, Buenos Aires", 2: "Juan García" },
+});
+```
+
+Each `ParameterDefinition` has:
+
+| Field         | Type     | Required | Description                                             |
+| ------------- | -------- | -------- | ------------------------------------------------------- |
+| `key`         | `number` | ✅       | 1-based index matching `{{?N}}` in the prompt           |
+| `label`       | `string` | ✅       | Human-friendly name shown in the UI and API errors      |
+| `description` | `string` |          | Optional hint shown to the user when filling values     |
+| `maxChars`    | `number` |          | Character limit for this parameter (1–500, default 200) |
+
+**Validation rules:**
+
+- Every `{{?N}}` placeholder in the prompt must have a matching `ParameterDefinition`.
+- A `400 Bad Request` is returned if a required parameter is missing or exceeds its `maxChars` limit.
+- The fully substituted prompt must not exceed **3 000 characters** total; adjust individual `maxChars` values accordingly.
+
 #### `getOcrTools()`
 
 Returns all OCR tool configurations owned by the authenticated user.
 
 ```js
 const tools = await getOcrTools();
-tools.forEach(t => console.log(t.id, t.name, t.outputType));
+tools.forEach((t) => console.log(t.id, t.name, t.outputType));
 ```
 
 ---
@@ -607,18 +683,20 @@ tools.forEach(t => console.log(t.id, t.name, t.outputType));
 
 Creates a new OCR tool configuration.
 
-| Field        | Type                           | Required | Description                                        |
-| ------------ | ------------------------------ | -------- | -------------------------------------------------- |
-| `name`       | `string`                       | ✅       | Human-friendly display name                        |
-| `prompt`     | `string`                       | ✅       | Natural-language instruction for the AI            |
-| `outputType` | `"YES_NO" \| "LABEL" \| "TEXT"` | ✅       | Expected output shape                              |
-| `labels`     | `string[]`                     | ⚠️      | Required when `outputType === "LABEL"`             |
+| Field                  | Type                            | Required | Description                                               |
+| ---------------------- | ------------------------------- | -------- | --------------------------------------------------------- |
+| `name`                 | `string`                        | ✅       | Human-friendly display name                               |
+| `prompt`               | `string`                        | ✅       | Natural-language instruction for the AI (max 3 000 chars) |
+| `outputType`           | `"YES_NO" \| "LABEL" \| "TEXT"` | ✅       | Expected output shape                                     |
+| `labels`               | `string[]`                      | ⚠️       | Required when `outputType === "LABEL"`                    |
+| `parameterDefinitions` | `ParameterDefinition[]`         |          | Dynamic parameter definitions for `{{?N}}` placeholders   |
 
 ```js
 // YES/NO check
 const checker = await createOcrTool({
   name: "Proof of Residence Check",
-  prompt: "Does this document appear to be a valid proof of residence? Look for an address, official stamp, and the person's name.",
+  prompt:
+    "Does this document appear to be a valid proof of residence? Look for an address, official stamp, and the person's name.",
   outputType: "YES_NO",
 });
 
@@ -627,13 +705,21 @@ const classifier = await createOcrTool({
   name: "Document Type Classifier",
   prompt: "What type of document is this?",
   outputType: "LABEL",
-  labels: ["invoice", "id_card", "receipt", "proof_of_residence", "contract", "other"],
+  labels: [
+    "invoice",
+    "id_card",
+    "receipt",
+    "proof_of_residence",
+    "contract",
+    "other",
+  ],
 });
 
 // Free-form extraction
 const extractor = await createOcrTool({
   name: "Serial Number Extractor",
-  prompt: "Extract the serial number or product code printed on the label. Return only the code, nothing else.",
+  prompt:
+    "Extract the serial number or product code printed on the label. Return only the code, nothing else.",
   outputType: "TEXT",
 });
 ```
@@ -646,7 +732,8 @@ Updates an existing OCR tool configuration.
 
 ```js
 await updateOcrTool("tool_abc", {
-  prompt: "Does this document show a current address dated within the last 3 months?",
+  prompt:
+    "Does this document show a current address dated within the last 3 months?",
 });
 ```
 
@@ -662,24 +749,36 @@ await deleteOcrTool("tool_abc");
 
 ---
 
-#### `runOcrTool(id, base64Image)`
+#### `runOcrTool(id, base64Image, options?)`
 
 Runs an OCR tool against a base64-encoded image. Max image size: **5 MB**.
 
-**Consumes AI credits.**
+**Consumes 1 document credit + AI credits** (based on token usage).
+
+The AI output language matches the language of the prompt / parameter values automatically.
+
+| Option   | Type                     | Description                                      |
+| -------- | ------------------------ | ------------------------------------------------ |
+| `params` | `Record<string, string>` | Values for `{{?N}}` placeholders, keyed by `"N"` |
 
 ```js
 import { readFileSync } from "fs";
 const image = readFileSync("./id-card.jpg").toString("base64");
 
 const result = await runOcrTool("tool_residence_check", image);
-console.log(result.answer);      // "YES"
+console.log(result.answer); // "YES"
 console.log(result.explanation); // "The document shows a full address, an official municipal stamp, and the applicant's name."
 
 // Document classification
 const type = await runOcrTool("tool_classifier", image);
 console.log(type.answer); // "id_card"
 
+// With dynamic parameters
+const ownership = await runOcrTool("tool_ownership_check", image, {
+  params: { 1: "Av. Corrientes 1234, CABA", 2: "María López" },
+});
+console.log(ownership.answer); // "YES"
+
 // Full workflow: classify first, then extract
 const { answer: docType } = await runOcrTool("tool_classifier", invoiceBase64);
 if (docType === "invoice") {
@@ -687,6 +786,14 @@ if (docType === "invoice") {
 }
 ```
 
+**Error responses:**
+
+| HTTP | Condition                                                                                              |
+| ---- | ------------------------------------------------------------------------------------------------------ |
+| 400  | Missing required parameter, value exceeds `maxChars`, or prompt exceeds 3 000 chars after substitution |
+| 402  | Document quota exhausted — upgrade plan or purchase add-on docs                                        |
+| 402  | AI credits exhausted — purchase add-on credits                                                         |
+
 ---
 
 ### Credits & Analytics
@@ -708,20 +815,101 @@ console.log(`Total available: ${balance.totalBalance}`);
 
 Returns a paginated history of AI credit consumption events (newest first).
 
-| Option  | Type     | Default | Description               |
-| ------- | -------- | ------- | ------------------------- |
-| `page`  | `number` | `0`     | Zero-based page index     |
-| `size`  | `number` | `20`    | Page size (max 100)       |
+| Option | Type     | Default | Description           |
+| ------ | -------- | ------- | --------------------- |
+| `page` | `number` | `0`     | Zero-based page index |
+| `size` | `number` | `20`    | Page size (max 100)   |
 
 ```js
 const history = await getCreditsHistory({ page: 0, size: 10 });
-history.content.forEach(entry => {
+history.content.forEach((entry) => {
   console.log(entry.timestamp, entry.operation, entry.creditsConsumed);
 });
 ```
 
 ---
 
+## Sub-Users
+
+> Requires a **Pro or higher** plan. The plan determines the maximum number of sub-users allowed.
+
+Sub-users can log in to the web app and operate within the permissions you grant them.  
+Available permissions: `"upload"` · `"view"` · `"template"` · `"settings"` · `"export"` · `"api"`
+
+### Document History
+
+```js
+import { getDocumentHistory } from 'extractia-sdk';
+
+const log = await getDocumentHistory({ page: 0, size: 20 });
+log.content.forEach((entry) => {
+  console.log(entry.templateName, entry.status, entry.uploadDate);
+  if (entry.status === 'FAILURE') console.error(entry.errorMessage);
+});
+```
+
+### List Sub-Users
+
+```js
+import { getSubUsers } from 'extractia-sdk';
+
+const users = await getSubUsers();
+// [{ username: 'agent_carlos', permissions: ['upload','view'], suspended: false }]
+```
+
+### Create a Sub-User
+
+```js
+import { createSubUser } from 'extractia-sdk';
+
+const sub = await createSubUser({
+  username: 'agent_carlos',
+  password: 'SecurePass1',
+  permissions: ['upload', 'view'],
+});
+```
+
+**Error codes:**
+| Code | Reason |
+|------|--------|
+| `403` | Plan does not allow sub-users or limit reached |
+| `409` | Username already in use |
+| `400` | Missing fields or password matches the main account |
+
+### Update Permissions or Password
+
+Only the fields you include are changed. Omit `password` to keep it unchanged.
+
+```js
+import { updateSubUser } from 'extractia-sdk';
+
+await updateSubUser('agent_carlos', {
+  permissions: ['upload', 'view', 'export'],
+  // password: 'NewPass99',   ← optional
+});
+```
+
+### Delete a Sub-User
+
+```js
+import { deleteSubUser } from 'extractia-sdk';
+
+await deleteSubUser('agent_carlos');
+```
+
+### Suspend / Reactivate
+
+A suspended sub-user cannot log in. Calling the same method again reactivates them.
+
+```js
+import { toggleSuspendSubUser } from 'extractia-sdk';
+
+const state = await toggleSuspendSubUser('agent_carlos');
+console.log(state.suspended); // true | false
+```
+
+---
+
 ## TypeScript
 
 The SDK ships with a full `index.d.ts` declaration file — no `@types` package needed.
@@ -780,6 +968,17 @@ Purchase extra document packs or upgrade your plan from the dashboard to continu
 
 ## Changelog
 
+### v1.2.0
+
+- **New:** `getDocumentHistory(opts?)` — paginated log of all document processing events (successes and failures)
+- **New:** `getSubUsers()` — list all sub-users under your account
+- **New:** `createSubUser({ username, password, permissions })` — create a sub-user (Pro+ plans)
+- **New:** `updateSubUser(username, updates)` — change permissions or password of a sub-user
+- **New:** `deleteSubUser(username)` — permanently remove a sub-user
+- **New:** `toggleSuspendSubUser(username)` — suspend or reactivate a sub-user
+- **Updated:** `getMyProfile()` response now includes `documentsAvailableThisMonth` and `extraDocsAvailable` quota fields
+- Updated TypeScript declarations: `AppUserProfile`, `DocumentAuditEntry`, `SubUser` interfaces; all new function signatures
+
 ### v1.1.0
 
 - **New:** `suggestFields(templateName, context?)` — AI-powered field suggestions

package/dist/extractia-sdk.browser.js

@@ -2671,7 +2671,7 @@ var ExtractiaSDK = (() => {
 
   // src/apiClient.js
   var token = null;
-  var DEFAULT_BASE_URL = "https://www.extractia-api.cat/api/public";
+  var DEFAULT_BASE_URL = "https://api.extractia.info/api/public";
   var api = axios_default.create({
     baseURL: DEFAULT_BASE_URL,
     timeout: 6e4
@@ -2788,11 +2788,15 @@ var ExtractiaSDK = (() => {
   }
   async function getDocumentById(templateId, docId, options = {}) {
     const params = { includeImage: options.includeImage ? 1 : 0 };
-    const res = await apiClient_default.get(`/templates/${templateId}/documents/${docId}`, { params });
+    const res = await apiClient_default.get(`/templates/${templateId}/documents/${docId}`, {
+      params
+    });
     return res.data;
   }
   async function getRecentDocuments(size = 10) {
-    const res = await apiClient_default.get("/documents/recent", { params: { size: Math.min(size, 50) } });
+    const res = await apiClient_default.get("/documents/recent", {
+      params: { size: Math.min(size, 50) }
+    });
     return res.data;
   }
   async function deleteDocument(documentId) {
@@ -2800,11 +2804,15 @@ var ExtractiaSDK = (() => {
     return res.data;
   }
   async function processImage(templateId, base64Image) {
-    const res = await apiClient_default.post(`/templates/${templateId}/process`, { image: base64Image });
+    const res = await apiClient_default.post(`/templates/${templateId}/process`, {
+      image: base64Image
+    });
     return res.data;
   }
   async function processImagesMultipage(templateId, base64ImagesArray) {
-    const res = await apiClient_default.post(`/templates/${templateId}/process-multipage`, { images: base64ImagesArray });
+    const res = await apiClient_default.post(`/templates/${templateId}/process-multipage`, {
+      images: base64ImagesArray
+    });
     return res.data;
   }
   async function generateDocumentSummary(docId) {
@@ -2833,7 +2841,8 @@ var ExtractiaSDK = (() => {
   }
   async function exportDocumentsCsv(templateId, options = {}) {
     const params = {};
-    if (options.fields && options.fields.length > 0) params.fields = options.fields.join(",");
+    if (options.fields && options.fields.length > 0)
+      params.fields = options.fields.join(",");
     const res = await apiClient_default.get(`/templates/${templateId}/documents/export/csv`, {
       params,
       responseType: "text"
@@ -2849,7 +2858,8 @@ var ExtractiaSDK = (() => {
   var analytics_exports = {};
   __export(analytics_exports, {
     getCreditsBalance: () => getCreditsBalance,
-    getCreditsHistory: () => getCreditsHistory
+    getCreditsHistory: () => getCreditsHistory,
+    getDocumentHistory: () => getDocumentHistory
   });
   async function getCreditsBalance() {
     const res = await apiClient_default.get("/me/credits");
@@ -2861,6 +2871,12 @@ var ExtractiaSDK = (() => {
     });
     return res.data;
   }
+  async function getDocumentHistory({ page = 0, size = 20 } = {}) {
+    const res = await apiClient_default.get("/me/documents/history", {
+      params: { page, size: Math.min(size, 100) }
+    });
+    return res.data;
+  }
 
   // src/ocrTools.js
   var ocrTools_exports = {};
@@ -2887,8 +2903,12 @@ var ExtractiaSDK = (() => {
     const res = await apiClient_default.delete(`/ocr-tools/${id}`);
     return res.data;
   }
-  async function runOcrTool(id, base64Image) {
-    const res = await apiClient_default.post(`/ocr-tools/${id}/run`, { image: base64Image });
+  async function runOcrTool(id, base64Image, options = {}) {
+    const body = { image: base64Image };
+    if (options.params && Object.keys(options.params).length > 0) {
+      body.params = options.params;
+    }
+    const res = await apiClient_default.post(`/ocr-tools/${id}/run`, body);
     return res.data;
   }