@nightsquawktech/invoiceninja-mcp-server 0.0.1

package/README.md

@@ -0,0 +1,128 @@
+# @nightsquawktech/invoiceninja-mcp-server
+
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/NightSquawk/invoiceninja-mcp-server/badge)](https://scorecard.dev/viewer/?uri=github.com/NightSquawk/invoiceninja-mcp-server)
+
+MCP server for **Invoice Ninja v5** (self-hosted). Exposes **all 379 API endpoints**
+through **3 consolidated tools** backed by a generated endpoint catalog, rather than
+one tool per endpoint.
+
+## Why a catalog, not 379 tools
+
+Invoice Ninja's REST API has ~379 operations across ~31 resources (full CRUD + bulk +
+actions + 27 reports). One MCP tool per endpoint would be unusable: huge context cost
+and poor tool selection. Instead, every endpoint is described by a JSON spec file under
+`src/catalog/endpoints/`, and three generic tools read that catalog:
+
+| Tool | Purpose |
+|------|---------|
+| `list_endpoints(category?, mutating?, search?)` | Discover endpoints (slug, method, path, category, mutating flag, one-line summary). |
+| `describe_endpoint(endpoint_name)` | Full spec for one endpoint: method, path, path/query params, request-body fields (types, required, enums, descriptions), and `whenToUse`. |
+| `call_endpoint(endpoint_name, path_params?, query?, body?, ...)` | Validate against the catalog, then execute. **Mutating** endpoints (POST/PUT/DELETE) require `authorization_confirmed: true` + `authorization_note` and are backed up to a temp file before the call. |
+
+Expected flow: **discover → describe → call**.
+
+## The endpoint catalog
+
+- `src/catalog/endpoints/<slug>.json`: one spec per endpoint, generated from the OpenAPI
+  spec (`openapi/api-docs.yaml` @ invoiceninja v5-stable). Carries method, path, name,
+  category, `mutating`, description, `whenToUse`, path/query/header parameters, and
+  request-body fields.
+- `src/catalog/index.json`: aggregate discovery index (slug, method, path, category,
+  mutating, summary) plus counts.
+
+Regenerate after a spec bump:
+
+```bash
+curl -sL https://raw.githubusercontent.com/invoiceninja/invoiceninja/v5-stable/openapi/api-docs.yaml -o spec/api-docs.yaml
+npm run generate     # parse spec -> src/catalog/endpoints/*.json
+npm run catalog      # rebuild src/catalog/index.json
+npm run build
+```
+
+The `whenToUse` field (when-to-reach-for-this guidance) is filled by an enrichment pass
+(`scripts/apply-enrichment.mjs`) and surfaced by `describe_endpoint` / `list_endpoints`.
+
+## Setup
+
+```bash
+npm install
+npm run build
+```
+
+## Environment (self-hosted)
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `INVOICENINJA_BASE_URL` | Yes | Instance URL, no trailing slash, no `/api/v1` (e.g. `https://your-instance.example.com`) |
+| `INVOICENINJA_API_TOKEN` | Yes | API token (Settings → Account Management → Integrations → API Tokens). Sent as `X-Api-Token`. |
+| `INVOICENINJA_TIMEOUT_MS` | No | Request timeout, default 30000 |
+
+## MCP client configuration
+
+```json
+{
+  "mcpServers": {
+    "invoiceninja": {
+      "command": "npx",
+      "args": ["-y", "@nightsquawktech/invoiceninja-mcp-server"],
+      "env": {
+        "INVOICENINJA_BASE_URL": "https://your-instance.example.com",
+        "INVOICENINJA_API_TOKEN": "<token>"
+      }
+    }
+  }
+}
+```
+
+## Write safety
+
+`call_endpoint` runs read-only GET endpoints freely. Any mutating endpoint requires
+`authorization_confirmed: true` and a non-empty `authorization_note`; without both,
+the call is refused before any HTTP request is made. Before a mutating call executes,
+the client writes a JSON backup (request payload, authorization note, and best-effort
+prior record for PUT/DELETE by id) under the system temp dir. The catalog flags every
+endpoint's `mutating` status, and as defense-in-depth any `{action}` route (email,
+mark_paid, archive, delete, clone, and similar) is treated as mutating even though
+some are GETs, so state-changing action endpoints can never run unguarded.
+
+## Smoke test (read-only)
+
+`scripts/smoke-test.mjs` sweeps every **non-mutating** endpoint against a live instance:
+186 of 379, including the 36 POST-but-read-only reports/charts/preview/templates/search
+(sent with an empty body so no side effect fires). It calls collection/report endpoints
+first, harvests sample ids, then exercises by-id endpoints, reporting PASS/FAIL/SKIP each.
+The 193 mutating endpoints (incl. the 6 state-changing `action_*` GETs) are excluded and
+the header says so, so a green run is never mistaken for full-API coverage.
+
+```bash
+INVOICENINJA_BASE_URL=... INVOICENINJA_API_TOKEN=... npm run build && npm run smoke
+```
+
+## Layout
+
+```
+src/
+  index.ts                          stdio MCP entry point
+  server/invoiceninja-mcp-server.ts singleton McpServer
+  catalog/
+    endpoint-spec.ts                catalog types + loader (traversal-guarded)
+    index.json                      generated discovery index
+    endpoints/<slug>.json           379 generated endpoint specs
+  clients/invoiceninja-client.ts    generic HTTP caller (X-Api-Token, backups)
+  tools/
+    list-endpoints.ts  describe-endpoint.ts  call-endpoint.ts
+  helpers/  types/
+scripts/
+  generate-catalog.mjs  parse OpenAPI spec -> endpoint files
+  assemble-catalog.mjs  endpoint files -> index.json
+  apply-enrichment.mjs  write whenToUse from the enrichment pass
+  smoke-test.mjs        read-only live sweep
+```
+
+See **[SCOPING.md](./SCOPING.md)** for the API inventory and design rationale.
+
+## License
+
+Licensed under the [GNU AGPL v3.0](./LICENSE). Free for personal and open-source use.
+
+Organizations that cannot comply with the AGPL can purchase a commercial license. See [COMMERCIAL.md](./COMMERCIAL.md) or contact hello@nightsquawk.tech.

package/dist/catalog/endpoint-spec.js

@@ -0,0 +1,36 @@
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
+import { createCatalogStore } from "@nightsquawktech/mcp-core/catalog";
+// Path resolution stays HERE, in the server, so it points at this server's
+// bundled catalog (dist/catalog) and not at the mcp-core package. The core
+// loader receives the resolved directory and never derives it from its own
+// module location.
+const catalogDir = dirname(fileURLToPath(import.meta.url)); // dist/catalog
+const store = createCatalogStore(catalogDir);
+/** The aggregate catalog index (slug, name, method, path, category per endpoint). */
+export function loadIndex() {
+    return store.index();
+}
+/** Full spec for a single endpoint, or null if the slug is unknown. */
+export function loadEndpointSpec(slug) {
+    // Entries live under endpoints/; the core store guards against path traversal.
+    return store.entry(slug);
+}
+/** True if the slug names a real endpoint. */
+export function isKnownEndpoint(slug) {
+    return loadIndex().endpoints.some((e) => e.slug === slug);
+}
+/** Distinct category names present in the catalog. */
+export function listCategories() {
+    return loadIndex().categories.map((c) => c.name);
+}
+/** Fuzzy slug suggestions for an unknown name. */
+export function suggestSlugs(query, limit = 6) {
+    if (!query)
+        return [];
+    const q = query.toLowerCase();
+    return loadIndex()
+        .endpoints.map((e) => e.slug)
+        .filter((s) => s.includes(q) || q.includes(s))
+        .slice(0, limit);
+}

package/dist/catalog/endpoints/action_invoice.json

@@ -0,0 +1,41 @@
+{
+  "slug": "action_invoice",
+  "operationId": "actionInvoice",
+  "method": "GET",
+  "path": "/api/v1/invoices/{id}/{action}",
+  "name": "Custom invoice action",
+  "category": "invoices",
+  "mutating": true,
+  "description": "Performs a custom action on an invoice.\nThe current range of actions are as follows\n- clone_to_invoice\n- clone_to_quote\n- history\n- delivery_note\n- mark_paid\n- download\n- archive\n- delete\n- email",
+  "whenToUse": "Perform a named action on one invoice by id (clone_to_quote, mark_paid, email, archive, history); use for these verbs, not update_invoice (mutating).",
+  "pathParameters": [
+    {
+      "name": "id",
+      "type": "string",
+      "required": true,
+      "description": "The Invoice Hashed ID",
+      "format": "string",
+      "example": "D2J234DFA"
+    },
+    {
+      "name": "action",
+      "type": "string",
+      "required": true,
+      "description": "The action string to be performed",
+      "format": "string",
+      "example": "clone_to_quote"
+    }
+  ],
+  "queryParameters": [
+    {
+      "name": "include",
+      "type": "string",
+      "required": false,
+      "description": "Includes child relationships in the response, format is comma separated. Check each model for the list of associated includes",
+      "example": "first_load"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": null,
+  "responseSchema": "Invoice"
+}

package/dist/catalog/endpoints/action_payment.json

@@ -0,0 +1,41 @@
+{
+  "slug": "action_payment",
+  "operationId": "actionPayment",
+  "method": "GET",
+  "path": "/api/v1/payments/{id}/{action}",
+  "name": "Custom payment actions",
+  "category": "payments",
+  "mutating": true,
+  "description": "Performs a custom action on an Payment.\n\n    The current range of actions are as follows\n    - clone_to_Payment\n    - clone_to_quote\n    - history\n    - delivery_note\n    - mark_paid\n    - download\n    - archive\n    - delete\n    - email",
+  "whenToUse": "Run a named action (mark_paid, email, download, clone, archive) on one payment by id and action string (mutating).",
+  "pathParameters": [
+    {
+      "name": "id",
+      "type": "string",
+      "required": true,
+      "description": "The Payment Hashed ID",
+      "format": "string",
+      "example": "D2J234DFA"
+    },
+    {
+      "name": "action",
+      "type": "string",
+      "required": true,
+      "description": "The action string to be performed",
+      "format": "string",
+      "example": "clone_to_quote"
+    }
+  ],
+  "queryParameters": [
+    {
+      "name": "include",
+      "type": "string",
+      "required": false,
+      "description": "Includes child relationships in the response, format is comma separated. Check each model for the list of associated includes",
+      "example": "first_load"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": null,
+  "responseSchema": "Payment"
+}

package/dist/catalog/endpoints/action_purchase_order.json

@@ -0,0 +1,41 @@
+{
+  "slug": "action_purchase_order",
+  "operationId": "actionPurchaseOrder",
+  "method": "GET",
+  "path": "/api/v1/purchase_orders/{id}/{action}",
+  "name": "Custom purchase order actions",
+  "category": "purchase_orders",
+  "mutating": true,
+  "description": "Performs a custom action on an purchase order.\n\n       The current range of actions are as follows\n       - mark_paid\n       - download\n       - archive\n       - delete\n       - email",
+  "whenToUse": "Run a named action (mark_paid, email, download, archive, delete) on one purchase order by id and action string (mutating).",
+  "pathParameters": [
+    {
+      "name": "id",
+      "type": "string",
+      "required": true,
+      "description": "The Purchase Order Hashed ID",
+      "format": "string",
+      "example": "D2J234DFA"
+    },
+    {
+      "name": "action",
+      "type": "string",
+      "required": true,
+      "description": "The action string to be performed",
+      "format": "string",
+      "example": "clone_to_quote"
+    }
+  ],
+  "queryParameters": [
+    {
+      "name": "include",
+      "type": "string",
+      "required": false,
+      "description": "Includes child relationships in the response, format is comma separated. Check each model for the list of associated includes",
+      "example": "first_load"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": null,
+  "responseSchema": "PurchaseOrder"
+}

package/dist/catalog/endpoints/action_quote.json

@@ -0,0 +1,41 @@
+{
+  "slug": "action_quote",
+  "operationId": "actionQuote",
+  "method": "GET",
+  "path": "/api/v1/quotes/{id}/{action}",
+  "name": "Performs a custom action on an Quote",
+  "category": "quotes",
+  "mutating": true,
+  "description": "Performs a custom action on an Quote.\n\n    The current range of actions are as follows\n    - clone_to_quote\n    - history\n    - delivery_note\n    - mark_paid\n    - download\n    - archive\n    - delete\n    - convert\n    - convert_to_invoice\n    - email",
+  "whenToUse": "Run a named action (clone, convert, mark_paid, email, archive) on one quote by id; use for quote workflow operations (mutating).",
+  "pathParameters": [
+    {
+      "name": "id",
+      "type": "string",
+      "required": true,
+      "description": "The Quote Hashed ID",
+      "format": "string",
+      "example": "D2J234DFA"
+    },
+    {
+      "name": "action",
+      "type": "string",
+      "required": true,
+      "description": "The action string to be performed",
+      "format": "string",
+      "example": "clone_to_quote"
+    }
+  ],
+  "queryParameters": [
+    {
+      "name": "include",
+      "type": "string",
+      "required": false,
+      "description": "Includes child relationships in the response, format is comma separated. Check each model for the list of associated includes",
+      "example": "first_load"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": null,
+  "responseSchema": "Quote"
+}

package/dist/catalog/endpoints/action_recurring_invoice.json

@@ -0,0 +1,41 @@
+{
+  "slug": "action_recurring_invoice",
+  "operationId": "actionRecurringInvoice",
+  "method": "GET",
+  "path": "/api/v1/recurring_invoices/{id}/{action}",
+  "name": "Custom recurring invoice action",
+  "category": "recurring_invoices",
+  "mutating": true,
+  "description": "Performs a custom action on an RecurringInvoice.\n\n    The current range of actions are as follows\n    - clone_to_RecurringInvoice\n    - clone_to_quote\n    - history\n    - delivery_note\n    - mark_paid\n    - download\n    - archive\n    - delete\n    - email",
+  "whenToUse": "Run a named action (start, mark_paid, email, clone, download) on one recurring invoice by id; use for single-record operations (mutating).",
+  "pathParameters": [
+    {
+      "name": "id",
+      "type": "string",
+      "required": true,
+      "description": "The RecurringInvoice Hashed ID",
+      "format": "string",
+      "example": "D2J234DFA"
+    },
+    {
+      "name": "action",
+      "type": "string",
+      "required": true,
+      "description": "The action string to be performed",
+      "format": "string",
+      "example": "clone_to_quote"
+    }
+  ],
+  "queryParameters": [
+    {
+      "name": "include",
+      "type": "string",
+      "required": false,
+      "description": "Includes child relationships in the response, format is comma separated. Check each model for the list of associated includes",
+      "example": "first_load"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": null,
+  "responseSchema": "RecurringInvoice"
+}

package/dist/catalog/endpoints/action_recurring_quote.json

@@ -0,0 +1,41 @@
+{
+  "slug": "action_recurring_quote",
+  "operationId": "actionRecurringQuote",
+  "method": "GET",
+  "path": "/api/v1/recurring_quotes/{id}/{action}",
+  "name": "Performs a custom action on an RecurringQuote",
+  "category": "recurring_quotes",
+  "mutating": true,
+  "description": "Performs a custom action on an RecurringQuote.\n\n    The current range of actions are as follows\n    - clone_to_RecurringQuote\n    - clone_to_quote\n    - history\n    - delivery_note\n    - mark_paid\n    - download\n    - archive\n    - delete\n    - email",
+  "whenToUse": "Run a named action (email, mark_paid, clone, download, history) on one recurring quote by id; use for operations beyond plain CRUD (mutating).",
+  "pathParameters": [
+    {
+      "name": "id",
+      "type": "string",
+      "required": true,
+      "description": "The RecurringQuote Hashed ID",
+      "format": "string",
+      "example": "D2J234DFA"
+    },
+    {
+      "name": "action",
+      "type": "string",
+      "required": true,
+      "description": "The action string to be performed",
+      "format": "string",
+      "example": "clone_to_quote"
+    }
+  ],
+  "queryParameters": [
+    {
+      "name": "include",
+      "type": "string",
+      "required": false,
+      "description": "Includes child relationships in the response, format is comma separated. Check each model for the list of associated includes",
+      "example": "first_load"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": null,
+  "responseSchema": "RecurringQuote"
+}

package/dist/catalog/endpoints/bulk_bank_integrations.json

@@ -0,0 +1,26 @@
+{
+  "slug": "bulk_bank_integrations",
+  "operationId": "bulkBankIntegrations",
+  "method": "POST",
+  "path": "/api/v1/bank_integrations/bulk",
+  "name": "Performs bulk actions on an array of bank_integrations",
+  "category": "bank_integrations",
+  "mutating": true,
+  "description": "Performs bulk actions on an array of bank_integrations",
+  "whenToUse": "Run a batch action over an array of bank integration ids; use for multi-record bank integration operations (mutating).",
+  "pathParameters": [],
+  "queryParameters": [
+    {
+      "name": "index",
+      "type": "string",
+      "required": false,
+      "description": "Replaces the default response index from data to a user specific string\n\nie.\n\n```html\n  ?index=new_index\n```\n\nresponse is wrapped\n\n```json\n  {\n    'new_index' : [\n      .....\n    ]\n  }\n```",
+      "example": "user"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": {
+    "contentType": "application/json",
+    "fields": []
+  }
+}

package/dist/catalog/endpoints/bulk_bank_transaction_rules.json

@@ -0,0 +1,26 @@
+{
+  "slug": "bulk_bank_transaction_rules",
+  "operationId": "bulkBankTransactionRules",
+  "method": "POST",
+  "path": "/api/v1/bank_transaction_rules/bulk",
+  "name": "Performs bulk actions on an array of bank_transaction rules",
+  "category": "bank_transaction_rules",
+  "mutating": true,
+  "description": "Performs bulk actions on an array of bank_transaction rules",
+  "whenToUse": "Apply one action across many bank transaction rule ids at once; reach for it for batch archive/restore operations (mutating).",
+  "pathParameters": [],
+  "queryParameters": [
+    {
+      "name": "index",
+      "type": "string",
+      "required": false,
+      "description": "Replaces the default response index from data to a user specific string\n\nie.\n\n```html\n  ?index=new_index\n```\n\nresponse is wrapped\n\n```json\n  {\n    'new_index' : [\n      .....\n    ]\n  }\n```",
+      "example": "user"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": {
+    "contentType": "application/json",
+    "fields": []
+  }
+}

package/dist/catalog/endpoints/bulk_bank_transactions.json

@@ -0,0 +1,26 @@
+{
+  "slug": "bulk_bank_transactions",
+  "operationId": "bulkBankTransactions",
+  "method": "POST",
+  "path": "/api/v1/bank_transactions/bulk",
+  "name": "Bulk actions",
+  "category": "bank_transactions",
+  "mutating": true,
+  "description": "Bulk actions",
+  "whenToUse": "Run a batch action over an array of bank transaction ids; use for actions across many transactions at once (mutating).",
+  "pathParameters": [],
+  "queryParameters": [
+    {
+      "name": "index",
+      "type": "string",
+      "required": false,
+      "description": "Replaces the default response index from data to a user specific string\n\nie.\n\n```html\n  ?index=new_index\n```\n\nresponse is wrapped\n\n```json\n  {\n    'new_index' : [\n      .....\n    ]\n  }\n```",
+      "example": "user"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": {
+    "contentType": "application/json",
+    "fields": []
+  }
+}

package/dist/catalog/endpoints/bulk_clients.json

@@ -0,0 +1,46 @@
+{
+  "slug": "bulk_clients",
+  "operationId": "bulkClients",
+  "method": "POST",
+  "path": "/api/v1/clients/bulk",
+  "name": "Bulk client actions",
+  "category": "clients",
+  "mutating": true,
+  "description": "##  POST /api/v1/clients/bulk\n\nBulk actions allow to make changes to multiple clients in a single request the following actions are supported\n\n- archive\n- restore\n- delete\n- template _requires template,template_id properties also_\n- assign_group _requires group_settings_id also_\n- bulk_update _requires column,new_value also_\n\nAll of these actions require an array of client ids to perform the requested action on ie.\n\n\"ids\":['id1','id2']\n\nactions such as template, assign_group and bulk_update also require additional properties to be passed in the request\n\n- template\n\nThe template bulk action allows the creation of a custom template using the provided template_id to be run against the array of clients provided.\n\n- assign_group\n\nAllows setting multiple clients to a single group\n\n- bulk_update\n\nAllows updating certain columns on the client model in bulk. the current list of supported columns that can be updated archived_at:\n\n- public_notes\n- industry_id\n- size_id\n- country_id\n- custom_value1\n- custom_value2\n- custom_value3\n- custom_value4",
+  "whenToUse": "Run a batch action (archive, restore, delete, assign_group, bulk_update, template) over an array of client ids in one request (mutating).",
+  "pathParameters": [],
+  "queryParameters": [
+    {
+      "name": "index",
+      "type": "string",
+      "required": false,
+      "description": "Replaces the default response index from data to a user specific string\n\nie.\n\n```html\n  ?index=new_index\n```\n\nresponse is wrapped\n\n```json\n  {\n    'new_index' : [\n      .....\n    ]\n  }\n```",
+      "example": "user"
+    },
+    {
+      "name": "include",
+      "type": "string",
+      "required": false,
+      "description": "Include child relationships of the Client Object. ie ?include=documents,system_logs\n\n```html\nAvailable includes:\n\ncontacts [All contacts related to the client]\ndocuments [All documents related to the client]\ngateway_tokens [All payment tokens related to the client]\nactivities [All activities related to the client]\nledger [The client ledger]\nsystem_logs [System logs related to the client]\ngroup_settings [The group settings object the client is assigned to]\n\n```\n\nUsage:\n\n```html\n/api/v1/clients?include=contacts,documents,activities\n```"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": {
+    "contentType": "application/json",
+    "fields": [
+      {
+        "name": "action",
+        "type": "string",
+        "required": false,
+        "description": "The action to perform ie. archive / restore / delete"
+      },
+      {
+        "name": "ids",
+        "type": "array",
+        "required": false
+      }
+    ],
+    "schemaRef": "GenericBulkAction"
+  },
+  "responseSchema": "Client"
+}

package/dist/catalog/endpoints/bulk_company_gateways.json

@@ -0,0 +1,27 @@
+{
+  "slug": "bulk_company_gateways",
+  "operationId": "bulkCompanyGateways",
+  "method": "POST",
+  "path": "/api/v1/company_gateways/bulk",
+  "name": "Performs bulk actions on an array of company_gateways",
+  "category": "company_gateways",
+  "mutating": true,
+  "description": "Performs bulk actions on an array of company_gateways",
+  "whenToUse": "Apply one action across many company gateway ids at once; reach for it for batch archive/restore operations (mutating).",
+  "pathParameters": [],
+  "queryParameters": [
+    {
+      "name": "index",
+      "type": "string",
+      "required": false,
+      "description": "Replaces the default response index from data to a user specific string\n\nie.\n\n```html\n  ?index=new_index\n```\n\nresponse is wrapped\n\n```json\n  {\n    'new_index' : [\n      .....\n    ]\n  }\n```",
+      "example": "user"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": {
+    "contentType": "application/json",
+    "fields": []
+  },
+  "responseSchema": "CompanyGateway"
+}

package/dist/catalog/endpoints/bulk_credits.json

@@ -0,0 +1,26 @@
+{
+  "slug": "bulk_credits",
+  "operationId": "bulkCredits",
+  "method": "POST",
+  "path": "/api/v1/credits/bulk",
+  "name": "Bulk credit actions",
+  "category": "credits",
+  "mutating": true,
+  "description": "Bulk credit actions",
+  "whenToUse": "Apply one action like email or mark_sent across many credit ids at once; reach for it for batch credit operations (mutating).",
+  "pathParameters": [],
+  "queryParameters": [
+    {
+      "name": "index",
+      "type": "string",
+      "required": false,
+      "description": "Replaces the default response index from data to a user specific string\n\nie.\n\n```html\n  ?index=new_index\n```\n\nresponse is wrapped\n\n```json\n  {\n    'new_index' : [\n      .....\n    ]\n  }\n```",
+      "example": "user"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": {
+    "contentType": "application/json",
+    "fields": []
+  }
+}

package/dist/catalog/endpoints/bulk_designs.json

@@ -0,0 +1,27 @@
+{
+  "slug": "bulk_designs",
+  "operationId": "bulkDesigns",
+  "method": "POST",
+  "path": "/api/v1/designs/bulk",
+  "name": "Performs bulk actions on an array of designs",
+  "category": "designs",
+  "mutating": true,
+  "description": "Performs bulk actions on an array of designs",
+  "whenToUse": "Apply one action across an array of design ids in a single batch instead of per-record calls (mutating).",
+  "pathParameters": [],
+  "queryParameters": [
+    {
+      "name": "index",
+      "type": "string",
+      "required": false,
+      "description": "Replaces the default response index from data to a user specific string\n\nie.\n\n```html\n  ?index=new_index\n```\n\nresponse is wrapped\n\n```json\n  {\n    'new_index' : [\n      .....\n    ]\n  }\n```",
+      "example": "user"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": {
+    "contentType": "application/json",
+    "fields": []
+  },
+  "responseSchema": "Design"
+}

package/dist/catalog/endpoints/bulk_expense_categorys.json

@@ -0,0 +1,27 @@
+{
+  "slug": "bulk_expense_categorys",
+  "operationId": "bulkExpenseCategorys",
+  "method": "POST",
+  "path": "/api/v1/expense_categories/bulk",
+  "name": "Performs bulk actions on an array of ExpenseCategorys",
+  "category": "expense_categories",
+  "mutating": true,
+  "description": "Performs bulk actions on an array of ExpenseCategorys",
+  "whenToUse": "Apply one action across an array of expense category ids in a single batch instead of per-record calls (mutating).",
+  "pathParameters": [],
+  "queryParameters": [
+    {
+      "name": "index",
+      "type": "string",
+      "required": false,
+      "description": "Replaces the default response index from data to a user specific string\n\nie.\n\n```html\n  ?index=new_index\n```\n\nresponse is wrapped\n\n```json\n  {\n    'new_index' : [\n      .....\n    ]\n  }\n```",
+      "example": "user"
+    }
+  ],
+  "headerParameters": [],
+  "requestBody": {
+    "contentType": "application/json",
+    "fields": []
+  },
+  "responseSchema": "Webhook"
+}