Skip to main content

API Changelog

Breaking changes, new features, and significant updates to epilot APIs. Subscribe via RSS

2026-03-03 Customer Portal API

  • New PRODUCT_RECOMMENDATIONS_WIDGET widget type was added; the new ProductRecommendationsWidget schema (extending TeaserWidget with a campaign_id field) is now available across the GET /v2/portal/widgets, GET /v2/portal/public-widgets, and POST /v2/portal/widgets endpoints

2026-03-03 Pricing API External Catalog

  • Breaking: The catalog_type enum values on POST /integration/external-service were renamed: products → product and products-recommendation → product-recommendations; the corresponding response schema was also renamed from ExternalCatalogProductsRecommendationResponse to ExternalCatalogProductRecommendationsResponse

2026-03-03 Message API

  • New GET /v1/message/messages/{id}/eml endpoint was added, returning a 302 redirect to a pre-signed URL for downloading the message as an EML file
  • New optional complete_thread field was added to message creation and draft endpoints (POST /v1/message/messages, POST /v1/message/drafts), marking the thread as Done immediately after the message is sent

2026-03-02 Blueprint Manifest API

  • New POST /v2/blueprint-manifest/blueprints/{blueprint_id}:format-description endpoint was added, which formats a blueprint description as markdown using AI (accepts a text field, returns markdown)
  • Breaking: compatible_apps field was removed from MarketplaceBlueprint and replaced by recommended_apps across all blueprint endpoints
  • New optional fields docs_url, recommended_apps, required_features, and zip_file_name were added to all blueprint types (AppBlueprint, CustomBlueprint, DeployedBlueprint, FileBlueprint, MarketplaceBlueprint)

2026-03-02 Workflows Definition API

  • New GET /v2/flows/templates/{flowId}/export endpoint was added, exporting a flow template with all referenced automations resolved and bundled
  • New POST /v2/flows/templates/import endpoint was added, importing a flow template from an export payload and creating all referenced automations in the caller's organization
  • Two new due_date_config/type enum values were added to flow templates: A_PRECEDING_TASK_COMPLETED and ALL_PRECEDING_TASKS_COMPLETED, enabling task and phase due dates to be relative to predecessor task completion; affects all /v2/flows/templates endpoints

2026-02-27 Workflows Execution API

  • The assigned_to field on executions, phases, and tasks now accepts variable assignment objects ({ variable, value }) in addition to plain user ID strings, enabling dynamic assignee resolution during workflow execution; affects POST /v2/flows/executions, GET and PATCH /v2/flows/executions/{execution_id}, PATCH /v2/flows/executions/{execution_id}/phases/{phase_id}, and task creation/update endpoints

2026-02-26 User API

  • New passkey authentication and management endpoints were added: POST /v2/users/public/passkeys:authenticateBegin and :authenticateBeginDiscoverable start a WebAuthn authentication flow; POST /v2/users/public/passkeys:resolveCredential resolves user identity from a discoverable assertion; POST /v2/users/me/passkeys:registerBegin and :registerComplete handle passkey registration; GET /v2/users/me/passkeys lists registered passkeys; DELETE /v2/users/me/passkeys/{credentialId} removes a passkey
  • New passkey_enabled boolean field was added to LoginParameters responses, indicating whether passkey login is available for the organization

2026-02-26 ERP Integration API

  • Breaking: The requires_vpc field in File Proxy use-case configuration is now read-only after creation — it can no longer be set or updated via the API; affects POST /v1/integrations/{integrationId}/use-cases, PUT /v1/integrations/{integrationId}/use-cases/{useCaseId}, and their v2 equivalents

2026-02-26 Workflows Definition API

  • PhaseMarkedInProgress and PhaseSkipped entity sync trigger event values were re-added to flow templates (reverting the 2026-02-23 removal) — affects all /v2/flows/templates endpoints

2026-02-26 Workflows Execution API

  • PhaseMarkedInProgress and PhaseSkipped entity sync trigger event values were re-added to execution responses (reverting the 2026-02-23 removal); TaskMarkedOnHold entity sync trigger event value was also added — affects POST /v2/flows/executions, GET /v2/flows/executions/{execution_id}, PATCH /v2/flows/executions/{execution_id}, and POST /v2/flows/executions:search

2026-02-25 Access Token API

  • New last_used field was added to access token responses, indicating the date the token was last used (YYYY-MM-DD format, 1-day accuracy); available in GET /v1/access-tokens, POST /v1/access-tokens, and DELETE /v1/access-tokens/{id} responses

2026-02-25 Billing API

  • Breaking: booking_date (date) is now a required field when creating or updating billing events — affects POST /v1/billing/events and PATCH /v1/billing/events/{id}
  • Breaking: due_date on InstallmentEvent changed from date-time to date format
  • Six new billing event types were added to the BillingEvent union: payment, dunning_fee, final_bill, bonus, correction, and custom — clients parsing event responses should handle these new variants
  • New optional fields were added to all billing event types: direction (debit/credit), status (open/closed), related_event, external_link, attachments, note, and internal_note

2026-02-25 App API

  • New CUSTOM_PAGE app component type was added — the new CustomPageComponent schema includes a required slug field (URL route, e.g. "zapier") and optional nav_label, nav_icon, and nav_description navigation fields; supported across all app and app-configuration endpoints

2026-02-25 GenAI API

  • New POST /v1/genai/entity/{slug}/{entity_id}/summary endpoint was added to generate AI summaries for entities, streaming the response via text/event-stream; supports optional language (de/en), variant (short/detailed/action_points), and current_summary parameters

2026-02-25 Workflows Definition API

  • Automation triggers and tasks in flow templates now support inline configuration: new optional trigger_config array on AutomationTrigger and new optional action_config object on AutomationTask.automation_config allow automation flows to be created or updated in place without a pre-existing ID — automation_id on triggers and flow_id on automation configs are now optional; affects all /v2/flows/templates endpoints

2026-02-24 ERP Integration API

  • Breaking: payload field on event update endpoints now enforces stricter validation — string payloads require minLength: 2 and object payloads require minProperties: 1; affects POST /v1/erp/updates/events, POST /v2/erp/updates/events, and POST /v3/erp/updates/events
  • New warnings array was added to mapping simulation responses (POST /v1/erp/updates/mapping_simulation, POST /v2/erp/updates/mapping_simulation), reporting validation issues about the configuration such as unique ID fields referencing non-indexed attributes

2026-02-23 Message API

  • New POST /v2/message/threads/{id}/assign:users endpoint was added, allowing users to be added or removed from a message thread

2026-02-23 Workflows Execution API

  • PhaseMarkedInProgress and PhaseSkipped enum values were removed from the trigger/event field in entity sync responses — affects POST /v2/flows/executions, GET /v2/flows/executions/{execution_id}, PATCH /v2/flows/executions/{execution_id}, and POST /v2/flows/executions:search

2026-02-23 Workflows Definition API

  • PhaseMarkedInProgress and PhaseSkipped enum values were removed from the entity_sync/trigger/event field across all flow template endpoints — affects request body of POST and PUT /v2/flows/templates/{flowId}, and responses of GET, POST, PUT /v2/flows/templates, POST /v2/flows/templates:search
  • New TaskMarkedOnHold trigger event value was added to entity_sync/trigger/event, enabling entity sync rules to fire when a task is placed on hold

2026-02-23 Customer Portal API

  • New allowed_portal_entities field was added to portal config request and response schemas — accepts an array of entity slugs (e.g., contact, contract) to restrict which entity types are accessible in the portal; available across all v2 and v3 portal config endpoints

2026-02-23 Automation API

  • New assign-thread automation action type was added — AssignThreadAction and AssignThreadConfig schemas allow automations to add or remove assignees from message threads

2026-02-23 Meter Entity

  • New me_lo_id field was added for storing the MeLo-ID (Messlokation) measurement location identifier

2026-02-22 Blueprint Manifest API

  • New optional archived query parameter was added to GET /v2/blueprint-manifest/blueprints to filter by archived status
  • New optional archived field was added to blueprint objects, indicating whether a blueprint is soft-deleted and hidden from the main list

2026-02-22 Entity API

  • New table schema attribute type was added

2026-02-20 ERP Integration API

  • Integration create/update/get response schemas restructured — fields now composed via allOf[IntegrationEditableFields]; SDK consumers should regenerate types
  • settings.autoRefresh.minIntervalBetweenSyncsMinutes was removed from integration settings