Skip to main content

API Changelog

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

Showing changes to all APIs. This includes APIs for specific platform features, which are not part of the core APIs integrations are built on and change more often. Show core APIs only

March 7, 2026

GenAI API

New New POST /v1/genai/search/query:generate endpoint added โ€” generates an AI-optimized Elasticsearch Lucene query from natural language input; accepts input, schemas, and locale in the request; returns query, confidence, and intent in the response

March 5, 2026

ERP Integration API

New New oauth2_password auth type added to file proxy use case authentication configuration, with username and password credential fields

March 4, 2026

File API

New New optional version_only query parameter added to POST /v1/files and POST /v2/files โ€” when true, creates a new file version without overwriting top-level entity metadata

Changed POST /v2/files now accepts an array of up to 20 BatchSaveFileVersionPayload objects when version_only=true, enabling batch version saves in a single request

March 3, 2026

Customer Portal API

New 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

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

Breaking The POST /v1/public/integration/{integrationId}/products-recommendation and POST /v1/public/external-catalog/products-recommendation endpoints were renamed to product-recommendations; new endpoints at the updated paths are now available

Breaking The coupons field in external catalog responses changed from an array to a single object

New New optional before_discount_amount_subtotal fields added to pricing line item responses

Changed postal_code is no longer a required field in availability filter requests

Message API

New 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 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

March 2, 2026

Blueprint Manifest API

Breaking compatible_apps field was removed from MarketplaceBlueprint and replaced by recommended_apps across all blueprint endpoints

New 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)

New New optional fields docs_url, recommended_apps, required_features, and zip_file_name were added to all blueprint types (AppBlueprint, CustomBlueprint, DeployedBlueprint, FileBlueprint, MarketplaceBlueprint)

Workflows Definition API

New New GET /v2/flows/templates/{flowId}/export endpoint was added, exporting a flow template with all referenced automations resolved and bundled

New 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

Changed 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

February 27, 2026

Workflows Execution API

Changed 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

February 26, 2026

User API

New 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 New passkey_enabled boolean field was added to LoginParameters responses, indicating whether passkey login is available for the organization

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

Workflows Definition API

Changed 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

Workflows Execution API

Changed 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

February 25, 2026

Access Token API

New 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

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

New 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

Changed 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

App API

New 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

GenAI API

New 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

Workflows Definition API

Changed 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

February 24, 2026

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 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

February 23, 2026

Message API

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

Workflows Execution API

Changed 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

Workflows Definition API

New 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

Changed 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

Customer Portal API

New 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

Automation API

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

Meter Entity

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