@epilot/cli 0.1.22 → 0.1.24

package/README.md

@@ -29,7 +29,7 @@ npm install -g @epilot/cli
 
 <!-- usage-help -->
 ```
-epilot v0.1.22 — CLI for epilot APIs
+epilot v0.1.24 — CLI for epilot APIs
 
 USAGE
   epilot <api> <operationId> [params...] [flags]

package/definitions/automation.json

@@ -70,6 +70,15 @@
               "example": "600945fe-212e-4b97-acf7-391d64648384"
             }
           },
+          {
+            "name": "target_workflow",
+            "in": "query",
+            "description": "Filter by target workflow ID. Returns only automations that have a trigger-workflow action targeting this workflow.",
+            "schema": {
+              "type": "string",
+              "example": "wfABCDEFGH"
+            }
+          },
           {
             "name": "include_flows",
             "in": "query",
@@ -2239,6 +2248,11 @@
             "type": "boolean",
             "description": "When enabled, the email thread will be automatically marked as done after this action completes.",
             "default": false
+          },
+          "mark_as_read": {
+            "type": "boolean",
+            "description": "When enabled, the email thread will be marked as read after this action completes.",
+            "default": true
           }
         },
         "required": [
@@ -2323,6 +2337,11 @@
             "type": "boolean",
             "description": "When enabled, the email thread will be automatically marked as done after this action completes.",
             "default": false
+          },
+          "mark_as_read": {
+            "type": "boolean",
+            "description": "When enabled, the email thread will be marked as read after this action completes.",
+            "default": false
           }
         }
       },
@@ -2373,6 +2392,11 @@
             "description": "When enabled, the email thread will be automatically marked as done after this action completes.",
             "default": true
           },
+          "mark_as_read": {
+            "type": "boolean",
+            "description": "When enabled, the email thread will be marked as read after this action completes.",
+            "default": true
+          },
           "attachments": {
             "type": "array",
             "description": "Include extra file attachments in sent email.\nAttachments in email template will be sent regardless of this configuration.\n",
@@ -3438,6 +3462,24 @@
           },
           "_execution_chain": {
             "$ref": "#/components/schemas/ExecutionChain"
+          },
+          "entity_contexts": {
+            "type": "array",
+            "description": "Additional entity contexts from the parent flow execution. Used when an automation is triggered from a workflow task to carry all flow contexts into the automation, not just the primary entity.\n",
+            "items": {
+              "type": "object",
+              "properties": {
+                "entity_id": {
+                  "type": "string"
+                },
+                "entity_schema": {
+                  "type": "string"
+                },
+                "is_primary": {
+                  "type": "boolean"
+                }
+              }
+            }
           }
         }
       },

package/definitions/entity.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.2",
   "info": {
     "title": "Entity API",
-    "version": "2.8.0",
+    "version": "2.9.0",
     "description": "Flexible data layer for epilot Entities.\n\nUse this API configure and access your business objects like Contacts, Opportunities and Products.\n\n[Feature Documentation](https://docs.epilot.io/docs/entities/flexible-entities)\n"
   },
   "tags": [
@@ -1428,6 +1428,9 @@
             "schema": {
               "$ref": "#/components/schemas/FieldsParam"
             }
+          },
+          {
+            "$ref": "#/components/parameters/ApplyChangesetsQueryParam"
           }
         ],
         "responses": {
@@ -1619,6 +1622,9 @@
           },
           {
             "$ref": "#/components/parameters/ValidateEntityQueryParam"
+          },
+          {
+            "$ref": "#/components/parameters/DirectQueryParam"
           }
         ],
         "requestBody": {
@@ -1682,6 +1688,9 @@
           },
           {
             "$ref": "#/components/parameters/ValidateEntityQueryParam"
+          },
+          {
+            "$ref": "#/components/parameters/DirectQueryParam"
           }
         ],
         "requestBody": {
@@ -2023,6 +2032,138 @@
         }
       }
     },
+    "/v1/entity/{slug}/{id}/changesets/{attribute}:apply": {
+      "post": {
+        "operationId": "applyChangeset",
+        "summary": "applyChangeset",
+        "description": "Applies the proposed value from a pending changeset to the entity attribute\nand removes the changeset. Used for human approval of pending changes.\n",
+        "tags": [
+          "Entities"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntitySlugPathParam"
+          },
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "in": "path",
+            "name": "attribute",
+            "required": true,
+            "description": "Attribute name of the changeset to apply",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Changeset applied successfully — returns updated entity",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EntityItem"
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          }
+        }
+      }
+    },
+    "/v1/entity/{slug}/{id}/changesets/{attribute}:dismiss": {
+      "post": {
+        "operationId": "dismissChangeset",
+        "summary": "dismissChangeset",
+        "description": "Removes a pending changeset without applying it. The attribute value remains unchanged.\n",
+        "tags": [
+          "Entities"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntitySlugPathParam"
+          },
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "in": "path",
+            "name": "attribute",
+            "required": true,
+            "description": "Attribute name of the changeset to dismiss",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "reason": {
+                    "type": "string",
+                    "description": "Optional reason for dismissing the changeset"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Changeset dismissed successfully — returns updated entity",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EntityItem"
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          }
+        }
+      }
+    },
+    "/v1/entity/{slug}/{id}/changesets": {
+      "get": {
+        "operationId": "listChangesets",
+        "summary": "listChangesets",
+        "description": "Returns all pending changesets for an entity.",
+        "tags": [
+          "Entities"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntitySlugPathParam"
+          },
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Pending changesets for the entity",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ChangesetMap"
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          }
+        }
+      }
+    },
     "/v1/entity/{slug}/{id}/activity": {
       "get": {
         "operationId": "getEntityActivityFeed",
@@ -3704,7 +3845,7 @@
               "description": "ISO 8601 timestamp to filter jobs created after this time (e.g., 2023-01-01T00:00:00Z).",
               "type": "string",
               "format": "date-time",
-              "example": "2023-01-01T00:00:00.000Z"
+              "example": "2023-01-01T00:00:00Z"
             }
           },
           {
@@ -5497,6 +5638,24 @@
           },
           "has_primary": {
             "type": "boolean"
+          },
+          "edit_mode": {
+            "type": "string",
+            "description": "Controls how updates to this attribute are handled.\n- `direct` (default): update is applied immediately. No changeset created.\n- `external`: update creates a changeset, auto-cleared on matching external update (e.g. ERP inbound sync via ?direct=true).\n- `approval`: update creates a changeset, requires explicit human approval.\n",
+            "enum": [
+              "direct",
+              "external",
+              "approval"
+            ],
+            "default": "direct"
+          },
+          "edit_mode_config": {
+            "description": "Configuration for auto-clear matching on `edit_mode: external` attributes.\n`match_strategy` and `fuzzy_config` are only consulted for `external` mode —\nthey are ignored for `approval` mode, which resolves via explicit\n`:apply` / `:dismiss` endpoints and never auto-clears.\n",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/EditModeConfig"
+              }
+            ]
           }
         },
         "required": [
@@ -7417,6 +7576,15 @@
               "example": "123e4567-e89b-12d3-a456-426614174000"
             },
             "nullable": true
+          },
+          "_changesets": {
+            "readOnly": true,
+            "type": "object",
+            "nullable": true,
+            "description": "Pending attribute changesets for attributes configured with external or approval edit mode.\nRead-only via normal entity PATCH/PUT operations — cannot be set directly.\nUse the changeset management endpoints to apply or dismiss changesets.\n",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/Changeset"
+            }
           }
         },
         "example": {
@@ -8350,6 +8518,11 @@
             "type": "boolean",
             "description": "If true, return full entity objects in entityNodes instead of just entity IDs in nodes",
             "default": false
+          },
+          "apply_changesets": {
+            "type": "boolean",
+            "description": "When true and hydrate is also true, entity objects in entityNodes have pending changeset proposed values applied in-place. The _changesets field is still included in the response.",
+            "default": false
           }
         }
       },
@@ -8646,11 +8819,16 @@
                 "float",
                 "date",
                 "flattened",
-                "nested"
+                "nested",
+                "object"
               ]
             },
             "fields": {
               "additionalProperties": true
+            },
+            "dynamic": {
+              "type": "boolean",
+              "description": "When false, prevents ES from inferring types for nested fields. Used for _changesets where values can be any type."
             }
           }
         }
@@ -8717,7 +8895,7 @@
       },
       "ActivityType": {
         "type": "string",
-        "description": "A type for the activity. Used to categorize activities in the activity feed and for event subscriptions.\n\nBuilt-in entity activity types (custom activities can be defined as well):\n- EntityCreated\n- EntityUpdated\n- EntityDeleted\n- EntitySoftDeleted\n- EntityRestored\n- RelationsAdded\n- RelationsRemoved\n- RelationsSoftDeleted\n- RelationsRestored\n- RelationsDeleted\n"
+        "description": "A type for the activity. Used to categorize activities in the activity feed and for event subscriptions.\n\nBuilt-in entity activity types (custom activities can be defined as well):\n- EntityCreated\n- EntityUpdated\n- EntityDeleted\n- EntitySoftDeleted\n- EntityRestored\n- RelationsAdded\n- RelationsRemoved\n- RelationsSoftDeleted\n- RelationsRestored\n- RelationsDeleted\n- ChangesetCreated\n- ChangesetAutoCleared\n- ChangesetApplied\n- ChangesetDismissed\n"
       },
       "Activity": {
         "type": "object",
@@ -9505,6 +9683,195 @@
             "example": "Bad Request"
           }
         }
+      },
+      "ChangesetCreator": {
+        "type": "object",
+        "description": "Identifies the actor that created the changeset.",
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": "Type of actor that created the changeset",
+            "enum": [
+              "user",
+              "portal_user",
+              "api_client",
+              "automation"
+            ]
+          },
+          "id": {
+            "type": "string",
+            "description": "ID of the actor (user ID, portal user ID, API client ID, etc.)"
+          }
+        }
+      },
+      "Changeset": {
+        "type": "object",
+        "description": "A pending proposed change for a single entity attribute, awaiting external confirmation or human approval.",
+        "required": [
+          "proposed_value",
+          "created_at",
+          "edit_mode"
+        ],
+        "properties": {
+          "proposed_value": {
+            "description": "The proposed new value for the attribute. Type matches the attribute type."
+          },
+          "previous_value": {
+            "description": "The attribute value at the time the changeset was created. Stored for reference."
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Timestamp when the changeset was created"
+          },
+          "created_by": {
+            "$ref": "#/components/schemas/ChangesetCreator"
+          },
+          "edit_mode": {
+            "type": "string",
+            "description": "The edit mode that triggered this changeset.\n- `external`: auto-cleared by a matching `?direct=true` write (see `match_strategy`).\n- `approval`: resolved only via explicit `:apply` / `:dismiss` endpoints; never auto-clears.\n",
+            "enum": [
+              "external",
+              "approval"
+            ]
+          },
+          "match_strategy": {
+            "description": "Match strategy copied from the attribute's `edit_mode_config` at changeset\ncreation time. Only consulted when `edit_mode` is `external`; ignored for\n`approval` (which never auto-clears).\n",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/MatchStrategy"
+              }
+            ]
+          },
+          "source": {
+            "type": "string",
+            "description": "Optional label indicating where the change originated (e.g. end_customer_portal, installer_portal, journey, automation)"
+          },
+          "related_values": {
+            "type": "object",
+            "description": "Proposed and previous values for related fields in a multi-field attribute group (e.g. currency _decimal/_currency suffixes). Keyed by full field name.",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "proposed_value": {
+                  "description": "The proposed new value for the related field."
+                },
+                "previous_value": {
+                  "description": "The value of the related field when the changeset was created."
+                }
+              }
+            }
+          }
+        }
+      },
+      "ChangesetMap": {
+        "type": "object",
+        "description": "Map of attribute name to pending changeset. At most one changeset per attribute.",
+        "additionalProperties": {
+          "$ref": "#/components/schemas/Changeset"
+        }
+      },
+      "EditModeConfig": {
+        "type": "object",
+        "description": "Configuration for `edit_mode: external` auto-clear matching.\nFields here (`match_strategy`, `fuzzy_config`) only take effect when\n`edit_mode` is `external`. They are ignored for `edit_mode: approval`,\nwhich never auto-clears and is resolved exclusively via the\n`:apply` / `:dismiss` changeset endpoints.\n",
+        "properties": {
+          "match_strategy": {
+            "$ref": "#/components/schemas/MatchStrategy"
+          },
+          "fuzzy_config": {
+            "$ref": "#/components/schemas/FuzzyConfig"
+          }
+        }
+      },
+      "FuzzyConfig": {
+        "type": "object",
+        "description": "Configuration for fuzzy auto-clear matching on `edit_mode: external` attributes.\nNot used for `edit_mode: approval`.\n\nType compatibility with attribute shape is enforced at schema save time:\n- scalar string attributes: `suffix`, `digits_only`, `regex`\n- repeatable attributes: `set_equivalent`, `entry_match`, `ignore_fields`, `normalize_phone`\n- relation attributes: `relation_set`\n",
+        "required": [
+          "type"
+        ],
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": "Which fuzzy algorithm to apply.",
+            "enum": [
+              "suffix",
+              "digits_only",
+              "normalize_phone",
+              "ignore_fields",
+              "set_equivalent",
+              "entry_match",
+              "relation_set",
+              "regex"
+            ]
+          },
+          "suffix_length": {
+            "type": "integer",
+            "description": "For type=suffix: number of characters to compare from end of string."
+          },
+          "fields_to_ignore": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "For type=ignore_fields and type=set_equivalent: field names to exclude when comparing array entries. `_id` is always stripped by the platform regardless of this config."
+          },
+          "regex_flags": {
+            "type": "string",
+            "description": "For type=regex: flags to apply to the regex (e.g. 'i' for case-insensitive)."
+          },
+          "country_code": {
+            "type": "string",
+            "description": "For type=normalize_phone: country dialing code digits to strip (e.g. '49' for Germany). No '+' prefix."
+          },
+          "match_on": {
+            "type": "string",
+            "description": "For type=normalize_phone: attribute key within array entries to compare on (e.g. 'phone_number')."
+          },
+          "key": {
+            "description": "For type=entry_match: business key(s) within each entry used to match proposed entries against incoming entries.",
+            "oneOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            ]
+          },
+          "mode": {
+            "type": "string",
+            "description": "For type=entry_match and type=set_equivalent: how strict the comparison is.\n- `subset` (default for entry_match): every proposed entry must exist in incoming; extra incoming entries are allowed.\n- `exact_set` (default for set_equivalent): the two sides must contain the same entries (order-insensitive, multiset semantics).\n",
+            "enum": [
+              "subset",
+              "exact_set"
+            ]
+          },
+          "ordered": {
+            "type": "boolean",
+            "description": "For type=relation_set: when true, relation order is significant. Defaults to false (order-insensitive)."
+          },
+          "require_tags_match": {
+            "type": "boolean",
+            "description": "For type=relation_set: when true, each relation item's `_tags` must match on both sides (order-insensitive). Defaults to false — `_tags` are stripped before compare."
+          },
+          "pattern": {
+            "type": "string",
+            "description": "For type=regex: regular expression pattern to test the incoming value against."
+          }
+        }
+      },
+      "MatchStrategy": {
+        "type": "string",
+        "description": "Strategy for auto-clearing a changeset on an `edit_mode: external` attribute\nwhen a direct write (`?direct=true`) arrives — typically an ERP inbound sync.\nIgnored for `edit_mode: approval`, which does not auto-clear and is resolved\nexclusively via the `:apply` / `:dismiss` changeset endpoints.\n- `exact`: The inbound value must exactly match the proposed value (deep equality).\n- `fuzzy`: The inbound value is compared using the configured `fuzzy_config` algorithm.\n- `any`: Any update to the attribute clears the changeset, regardless of value.\n",
+        "enum": [
+          "exact",
+          "fuzzy",
+          "any"
+        ],
+        "default": "exact"
       }
     },
     "parameters": {
@@ -9741,6 +10108,26 @@
           "default": false,
           "type": "boolean"
         }
+      },
+      "DirectQueryParam": {
+        "name": "direct",
+        "description": "When true, bypasses changeset interception: attribute values in the payload\nare written directly to the entity regardless of each attribute's `edit_mode`.\nThe write always lands, independently of any auto-clear outcome below.\n\nAfter the direct write, for each attribute in the payload that also has a\npending changeset:\n- `edit_mode: external` — the incoming value is checked against the\n  changeset's `match_strategy` (and `fuzzy_config` when `fuzzy`). On match,\n  `_changesets[attr]` is cleared. On no-match, the write still stands and\n  the changeset stays pending (signalling the ERP/trusted source applied a\n  different correction than originally proposed; resolve via a later\n  matching direct write, or via the `:apply` / `:dismiss` endpoints).\n- `edit_mode: approval` — never auto-cleared. The write lands but the\n  pending changeset remains until explicitly resolved via `:apply` or\n  `:dismiss`.\n\nIntended for trusted integrations (e.g. ERP inbound sync). ERP middleware\nmust always use `?direct=true` — without it, an inbound sync on an\n`external` attribute would create a new changeset instead of confirming\nthe pending one.\n\nDefaults to false — no breaking change for existing callers.\n",
+        "in": "query",
+        "required": false,
+        "schema": {
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "ApplyChangesetsQueryParam": {
+        "name": "apply_changesets",
+        "description": "When true, applies pending changeset proposed values in-place on the response entity.\nThe response includes both the hydrated values and the raw _changesets field.\nDoes not mutate stored data — pure read-time transform.\n",
+        "in": "query",
+        "required": false,
+        "schema": {
+          "type": "boolean",
+          "default": false
+        }
       }
     },
     "examples": {

package/definitions/kanban.json

@@ -1257,7 +1257,8 @@
             "type": "string",
             "enum": [
               "context_entity",
-              "phase"
+              "phase",
+              "task"
             ],
             "description": "Property to group tasks by within each swimlane"
           }

package/definitions/pricing.json

@@ -2036,7 +2036,6 @@
                                 "unit_amount_gross_decimal": "25",
                                 "unit_amount_net": 25,
                                 "unit_amount_net_decimal": "25",
-                                "billing_period": null,
                                 "type": "one_time",
                                 "taxes": [],
                                 "pricing_model": "per_unit",
@@ -2109,20 +2108,22 @@
                                 "amount_subtotal_decimal": "25",
                                 "amount_subtotal": 2500,
                                 "unit_amount": 25,
-                                "unit_amount_gross": 29.75,
+                                "unit_amount_gross": 2975,
                                 "unit_amount_gross_decimal": "29.75",
                                 "unit_amount_net": 25,
                                 "unit_amount_net_decimal": "25",
-                                "billing_period": null,
                                 "type": "one_time",
                                 "taxes": [
                                   {
                                     "tax": {
-                                      "_id": "tax-vat-19",
-                                      "name": "VAT",
+                                      "_id": "24641e82-0690-4135-8b43-ef12a9b1c5dc",
+                                      "_title": "VAT 19%",
+                                      "_org": "728",
+                                      "_schema": "tax",
+                                      "_created_at": "2024-01-01T00:00:00.000Z",
+                                      "_updated_at": "2024-01-01T00:00:00.000Z",
                                       "type": "VAT",
-                                      "rate": 19,
-                                      "region": "DE"
+                                      "rate": 19
                                     },
                                     "amount": 475
                                   }
@@ -2140,15 +2141,16 @@
                                   "is_composite_price": false,
                                   "pricing_model": "per_unit",
                                   "price_display_in_journeys": "show_price",
-                                  "tax": [
-                                    {
-                                      "_id": "tax-vat-19",
-                                      "name": "VAT",
-                                      "type": "VAT",
-                                      "rate": 19,
-                                      "region": "DE"
-                                    }
-                                  ]
+                                  "tax": {
+                                    "_id": "24641e82-0690-4135-8b43-ef12a9b1c5dc",
+                                    "_title": "VAT 19%",
+                                    "_org": "728",
+                                    "_schema": "tax",
+                                    "_created_at": "2024-01-01T00:00:00.000Z",
+                                    "_updated_at": "2024-01-01T00:00:00.000Z",
+                                    "type": "VAT",
+                                    "rate": 19
+                                  }
                                 },
                                 "_product": {
                                   "_id": "product-93f857a4",
@@ -2168,11 +2170,14 @@
                               "taxes": [
                                 {
                                   "tax": {
-                                    "_id": "tax-vat-19",
-                                    "name": "VAT",
+                                    "_id": "24641e82-0690-4135-8b43-ef12a9b1c5dc",
+                                    "_title": "VAT 19%",
+                                    "_org": "728",
+                                    "_schema": "tax",
+                                    "_created_at": "2024-01-01T00:00:00.000Z",
+                                    "_updated_at": "2024-01-01T00:00:00.000Z",
                                     "type": "VAT",
-                                    "rate": 19,
-                                    "region": "DE"
+                                    "rate": 19
                                   },
                                   "amount": 475
                                 }
@@ -2722,6 +2727,17 @@
         "tags": [
           "External Catalog API"
         ],
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-epilot-org-id",
+            "schema": {
+              "type": "string"
+            },
+            "required": false,
+            "description": "Organization ID (required when not using EpilotPublicAuth token)"
+          }
+        ],
         "requestBody": {
           "required": true,
           "content": {
@@ -2872,6 +2888,17 @@
         "tags": [
           "External Catalog API"
         ],
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-epilot-org-id",
+            "schema": {
+              "type": "string"
+            },
+            "required": false,
+            "description": "Organization ID (required when not using EpilotPublicAuth token)"
+          }
+        ],
         "requestBody": {
           "required": true,
           "content": {
@@ -3003,7 +3030,6 @@
                                 "unit_amount_gross_decimal": "25",
                                 "unit_amount_net": 25,
                                 "unit_amount_net_decimal": "25",
-                                "billing_period": null,
                                 "type": "one_time",
                                 "taxes": [],
                                 "pricing_model": "per_unit",
@@ -3076,20 +3102,22 @@
                                 "amount_subtotal_decimal": "25",
                                 "amount_subtotal": 2500,
                                 "unit_amount": 25,
-                                "unit_amount_gross": 29.75,
+                                "unit_amount_gross": 2975,
                                 "unit_amount_gross_decimal": "29.75",
                                 "unit_amount_net": 25,
                                 "unit_amount_net_decimal": "25",
-                                "billing_period": null,
                                 "type": "one_time",
                                 "taxes": [
                                   {
                                     "tax": {
-                                      "_id": "tax-vat-19",
-                                      "name": "VAT",
+                                      "_id": "24641e82-0690-4135-8b43-ef12a9b1c5dc",
+                                      "_title": "VAT 19%",
+                                      "_org": "728",
+                                      "_schema": "tax",
+                                      "_created_at": "2024-01-01T00:00:00.000Z",
+                                      "_updated_at": "2024-01-01T00:00:00.000Z",
                                       "type": "VAT",
-                                      "rate": 19,
-                                      "region": "DE"
+                                      "rate": 19
                                     },
                                     "amount": 475
                                   }
@@ -3107,15 +3135,16 @@
                                   "is_composite_price": false,
                                   "pricing_model": "per_unit",
                                   "price_display_in_journeys": "show_price",
-                                  "tax": [
-                                    {
-                                      "_id": "tax-vat-19",
-                                      "name": "VAT",
-                                      "type": "VAT",
-                                      "rate": 19,
-                                      "region": "DE"
-                                    }
-                                  ]
+                                  "tax": {
+                                    "_id": "24641e82-0690-4135-8b43-ef12a9b1c5dc",
+                                    "_title": "VAT 19%",
+                                    "_org": "728",
+                                    "_schema": "tax",
+                                    "_created_at": "2024-01-01T00:00:00.000Z",
+                                    "_updated_at": "2024-01-01T00:00:00.000Z",
+                                    "type": "VAT",
+                                    "rate": 19
+                                  }
                                 },
                                 "_product": {
                                   "_id": "product-93f857a4",
@@ -3135,11 +3164,14 @@
                               "taxes": [
                                 {
                                   "tax": {
-                                    "_id": "tax-vat-19",
-                                    "name": "VAT",
+                                    "_id": "24641e82-0690-4135-8b43-ef12a9b1c5dc",
+                                    "_title": "VAT 19%",
+                                    "_org": "728",
+                                    "_schema": "tax",
+                                    "_created_at": "2024-01-01T00:00:00.000Z",
+                                    "_updated_at": "2024-01-01T00:00:00.000Z",
                                     "type": "VAT",
-                                    "rate": 19,
-                                    "region": "DE"
+                                    "rate": 19
                                   },
                                   "amount": 475
                                 }
@@ -9112,8 +9144,8 @@
                 "description": "Description of the contract"
               },
               "billing_account": {
-                "type": "string",
-                "description": "Billing Account relation ID"
+                "type": "object",
+                "description": "Billing Account relation"
               },
               "account_number": {
                 "type": "string",
@@ -9121,14 +9153,7 @@
               },
               "branch": {
                 "type": "string",
-                "description": "Branch/commodity type",
-                "enum": [
-                  "power",
-                  "gas",
-                  "water",
-                  "waste_water",
-                  "district_heating"
-                ]
+                "description": "Branch/commodity type (e.g. power, gas, water, waste_water, district_heating, or any custom value)"
               },
               "move_in_date": {
                 "type": "string",
@@ -9141,12 +9166,15 @@
                 "description": "Move Out Date"
               },
               "billing_address": {
-                "type": "object",
-                "description": "Billing Address"
+                "description": "Billing Address",
+                "type": "object"
               },
               "delivery_address": {
-                "type": "object",
-                "description": "Delivery Address"
+                "description": "Delivery Address",
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
               },
               "additional_addresses": {
                 "type": "array",
@@ -9175,11 +9203,8 @@
                 "description": "End Date"
               },
               "customer": {
-                "type": "array",
-                "description": "Customer relation (contact or account)",
-                "items": {
-                  "type": "string"
-                }
+                "type": "object",
+                "description": "Customer relation (contact or account)"
               },
               "order": {
                 "type": "string",
@@ -9265,30 +9290,11 @@
                 "description": "Billing Due Day"
               },
               "installment_amount": {
-                "type": "object",
-                "description": "Installment Amount",
-                "properties": {
-                  "value": {
-                    "type": "number"
-                  },
-                  "currency": {
-                    "type": "string",
-                    "default": "EUR"
-                  }
-                }
+                "type": "number"
               },
               "balance": {
-                "type": "object",
-                "description": "Balance",
-                "properties": {
-                  "value": {
-                    "type": "number"
-                  },
-                  "currency": {
-                    "type": "string",
-                    "default": "EUR"
-                  }
-                }
+                "type": "number",
+                "description": "Balance"
               },
               "meters": {
                 "type": "array",
@@ -9298,8 +9304,8 @@
                 }
               },
               "payment": {
-                "type": "string",
-                "description": "Payment Details relation ID"
+                "type": "object",
+                "description": "Payment Details relation"
               },
               "last_sync_at": {
                 "type": "string",
@@ -9507,6 +9513,65 @@
                 "readOnly": true
               }
             }
+          },
+          "availability_address": {
+            "type": "object",
+            "description": "Address to use for product availability checks. Include when the catalog should filter products by serviceable area (e.g. postal code coverage).\n",
+            "properties": {
+              "postal_code": {
+                "type": "string",
+                "description": "Postal Code"
+              },
+              "city": {
+                "type": "string",
+                "description": "City"
+              },
+              "street": {
+                "type": "string",
+                "description": "Street"
+              },
+              "street_number": {
+                "type": "string",
+                "description": "Street Number"
+              },
+              "journey_target_block": {
+                "type": "string",
+                "description": "The journey target block of the availability address <step_index>/<block_name>"
+              }
+            }
+          },
+          "variable_inputs": {
+            "type": "array",
+            "description": "Variable inputs (e.g. energy or water consumption) extracted/provided by the portal so the external catalog service can compute amounts for variable prices.\n",
+            "items": {
+              "type": "object",
+              "properties": {
+                "value": {
+                  "type": "number",
+                  "description": "The value of the variable input"
+                },
+                "unit": {
+                  "type": "string",
+                  "description": "The unit of the variable input"
+                },
+                "frequency_unit": {
+                  "type": "string",
+                  "description": "The frequency unit of the variable input",
+                  "enum": [
+                    "weekly",
+                    "monthly",
+                    "every_quarter",
+                    "every_6_months",
+                    "yearly",
+                    "one_time"
+                  ]
+                },
+                "journey_target_block": {
+                  "type": "string",
+                  "description": "The journey target block of the variable input <step_index>/<block_name>"
+                }
+              }
+            }
           }
         },
         "required": [
@@ -9858,6 +9923,11 @@
                   {
                     "tax": {
                       "_id": "936db2a1-3748-45b6-bb9d-04943280ceeb",
+                      "_title": "VAT 23%",
+                      "_org": "728",
+                      "_schema": "tax",
+                      "_created_at": "2021-09-24T15:06:13.859Z",
+                      "_updated_at": "2021-09-24T15:06:13.859Z",
                       "type": "VAT",
                       "rate": 23
                     },
@@ -9866,6 +9936,11 @@
                   {
                     "tax": {
                       "_id": "936db2a1-3748-45b6-bb9d-04943280cee4",
+                      "_title": "VAT 7%",
+                      "_org": "728",
+                      "_schema": "tax",
+                      "_created_at": "2021-09-24T15:06:13.859Z",
+                      "_updated_at": "2021-09-24T15:06:13.859Z",
                       "type": "VAT",
                       "rate": 7
                     },

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-KI2MVPE4.js";
+} from "../chunk-U5JW65I3.js";
 
 // bin/epilot.ts
 import { runMain } from "citty";
@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.22",
+    version: "0.1.24",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -30,8 +30,8 @@ var main = defineCommand({
     auth: () => import("../auth-CN5EFFDE.js").then((m) => m.default),
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
-    completion: () => import("../completion-A3BQFVLK.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-XAY377R6.js").then((m) => m.default),
+    completion: () => import("../completion-76TTN5FM.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-3SGNJUWL.js").then((m) => m.default),
     "access-token": () => import("../access-token-WWE6BDJH.js").then((m) => m.default),
     address: () => import("../address-EH3C4CVB.js").then((m) => m.default),
     "address-suggestions": () => import("../address-suggestions-RRSLOBFW.js").then((m) => m.default),
@@ -132,13 +132,13 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.22" : (await null).default.version;
+var VERSION = true ? "0.1.24" : (await null).default.version;
 var reorderedArgv = hoistFlagsAfterSubcommand(process.argv.slice(2));
 process.argv = [process.argv[0], process.argv[1], ...reorderedArgv];
 var args = process.argv.slice(2);
 var completionsIdx = args.indexOf("--_completions");
 if (completionsIdx >= 0) {
-  const { handleCompletions } = await import("../completion-A3BQFVLK.js");
+  const { handleCompletions } = await import("../completion-76TTN5FM.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-KI2MVPE4.js → chunk-U5JW65I3.js}

@@ -515,7 +515,7 @@ var API_LIST = [
     kebabName: "entity",
     title: "Entity API",
     serverUrl: "https://entity.sls.epilot.io",
-    operationCount: 84,
+    operationCount: 87,
     operationIds: [
       "listSchemas",
       "listSchemasV2",
@@ -548,6 +548,9 @@ var API_LIST = [
       "createActivity",
       "getActivity",
       "attachActivity",
+      "applyChangeset",
+      "dismissChangeset",
+      "listChangesets",
       "getEntityActivityFeed",
       "getRelations",
       "addRelations",

package/dist/{completion-A3BQFVLK.js → completion-76TTN5FM.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "./chunk-KI2MVPE4.js";
+} from "./chunk-U5JW65I3.js";
 import {
   DIM,
   GREEN,

package/dist/{upgrade-XAY377R6.js → upgrade-3SGNJUWL.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.22";
+  if (true) return "0.1.24";
   try {
     const output = execSync("npm ls -g @epilot/cli --depth=0 --json 2>/dev/null", {
       encoding: "utf-8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/cli",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {