Skip to content

Commit 03bd6e3

Browse files
Add workflow export API to OpenAPI spec (Unstable)
- Add GET /export/workflows/{id} endpoint - Add Workflows tag - Add workflow_export schema This documents the workflow export API for EU Data Act compliance. Related PR: intercom/intercom#462983 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 970826f commit 03bd6e3

File tree

1 file changed

+154
-0
lines changed

1 file changed

+154
-0
lines changed

descriptions/0/api.intercom.io.yaml

Lines changed: 154 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9735,6 +9735,71 @@ paths:
97359735
download_expires_at: ''
97369736
schema:
97379737
"$ref": "#/components/schemas/data_export"
9738+
"/export/workflows/{id}":
9739+
get:
9740+
summary: Export a workflow
9741+
parameters:
9742+
- name: Intercom-Version
9743+
in: header
9744+
schema:
9745+
"$ref": "#/components/schemas/intercom_version"
9746+
- name: id
9747+
in: path
9748+
description: The unique identifier for the workflow
9749+
required: true
9750+
schema:
9751+
type: string
9752+
example: "12345"
9753+
tags:
9754+
- Workflows
9755+
operationId: exportWorkflow
9756+
description: |
9757+
Export a workflow configuration by its ID. This endpoint returns the complete workflow definition including its steps, targeting rules, and attributes.
9758+
9759+
This endpoint is designed for EU Data Act compliance, allowing customers to export their workflow configurations.
9760+
9761+
{% admonition type="warning" name="Unstable API" %}
9762+
This API is currently in the Unstable version. Its behavior may change in future releases.
9763+
{% /admonition %}
9764+
responses:
9765+
'200':
9766+
description: Workflow exported successfully
9767+
content:
9768+
application/json:
9769+
examples:
9770+
successful:
9771+
value:
9772+
export_version: "1.0"
9773+
exported_at: "2026-01-26T12:00:00Z"
9774+
app_id: 12345
9775+
workflow:
9776+
id: "67890"
9777+
title: "My Workflow"
9778+
description: "A workflow that handles customer inquiries"
9779+
trigger_type: "inbound_conversation"
9780+
state: "live"
9781+
target_channels: ["chat"]
9782+
preferred_devices: ["desktop", "mobile"]
9783+
created_at: "2025-06-15T10:30:00Z"
9784+
updated_at: "2026-01-20T14:45:00Z"
9785+
targeting: {}
9786+
snapshot: {}
9787+
attributes: []
9788+
embedded_rules: []
9789+
schema:
9790+
"$ref": "#/components/schemas/workflow_export"
9791+
'404':
9792+
description: Workflow not found
9793+
content:
9794+
application/json:
9795+
schema:
9796+
"$ref": "#/components/schemas/error"
9797+
'403':
9798+
description: Workflow export is not available for this app
9799+
content:
9800+
application/json:
9801+
schema:
9802+
"$ref": "#/components/schemas/error"
97389803
"/download/content/data/{job_identifier}":
97399804
get:
97409805
summary: Download content data export
@@ -23988,6 +24053,93 @@ components:
2398824053
type: string
2398924054
description: Automatically generated identifier for the Visitor.
2399024055
example: 8a88a590-e1c3-41e2-a502-e0649dbf721c
24056+
workflow_export:
24057+
title: Workflow Export
24058+
type: object
24059+
description: A workflow export containing the complete workflow configuration.
24060+
properties:
24061+
export_version:
24062+
type: string
24063+
description: The version of the export format.
24064+
example: "1.0"
24065+
exported_at:
24066+
type: string
24067+
format: date-time
24068+
description: The timestamp when the export was generated.
24069+
example: "2026-01-26T12:00:00Z"
24070+
app_id:
24071+
type: integer
24072+
description: The workspace identifier.
24073+
example: 12345
24074+
workflow:
24075+
type: object
24076+
description: The workflow configuration.
24077+
properties:
24078+
id:
24079+
type: string
24080+
description: The unique identifier for the workflow.
24081+
example: "67890"
24082+
title:
24083+
type: string
24084+
description: The title of the workflow.
24085+
example: "My Workflow"
24086+
description:
24087+
type: string
24088+
nullable: true
24089+
description: The description of the workflow.
24090+
example: "A workflow that handles customer inquiries"
24091+
trigger_type:
24092+
type: string
24093+
description: The type of trigger that starts this workflow.
24094+
example: "inbound_conversation"
24095+
state:
24096+
type: string
24097+
description: The current state of the workflow.
24098+
enum:
24099+
- live
24100+
- draft
24101+
- paused
24102+
example: "live"
24103+
target_channels:
24104+
type: array
24105+
items:
24106+
type: string
24107+
description: The channels this workflow targets.
24108+
example: ["chat"]
24109+
preferred_devices:
24110+
type: array
24111+
items:
24112+
type: string
24113+
description: The preferred devices for this workflow.
24114+
example: ["desktop", "mobile"]
24115+
created_at:
24116+
type: string
24117+
format: date-time
24118+
description: When the workflow was created.
24119+
example: "2025-06-15T10:30:00Z"
24120+
updated_at:
24121+
type: string
24122+
format: date-time
24123+
description: When the workflow was last updated.
24124+
example: "2026-01-20T14:45:00Z"
24125+
targeting:
24126+
type: object
24127+
nullable: true
24128+
description: The targeting rules for this workflow.
24129+
snapshot:
24130+
type: object
24131+
nullable: true
24132+
description: The current snapshot of workflow steps and configuration.
24133+
attributes:
24134+
type: array
24135+
items:
24136+
type: object
24137+
description: Custom attributes defined for this workflow.
24138+
embedded_rules:
24139+
type: array
24140+
items:
24141+
type: object
24142+
description: Rules embedded within the workflow steps.
2399124143
ai_call_response:
2399224144
title: AI Call Response
2399324145
type: object
@@ -24278,3 +24430,5 @@ tags:
2427824430
description: Everything about your tickets
2427924431
- name: Visitors
2428024432
description: Everything about your Visitors
24433+
- name: Workflows
24434+
description: Export workflow configurations from your workspace.

0 commit comments

Comments
 (0)