Interactor User Defined Automation Configuration and Execution API (6.0.0)

Download OpenAPI specification:Download

Interactor: info@interactor.com URL: https://interactor.com

The API allows configuration and execution of Interactor user automation.

Get user automations for a given user id

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

Responses

Response samples

200

Content type

application/json

[{"enabled": true,
"id": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf",
"name": "test automation",
"status": "active",
"group_id": "test_group",
"user_id": "user-0000-0000-0000-000000000000",
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"platform_id": "interactor",
"default_version_id": "1be79b21-487f-4cee-a744-261566077859",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}
]

Create new user automation for a given user id

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

name required	string
group_id required	string
trigger_version_id required	string
service_token_id required	string
trigger required	object (automationTrigger)
logic required	object (logic)

Responses

Request samples

Payload

Content type

application/json

{"name": "test automation",
"group_id": "test_group",
"trigger_version_id": "9a236faa-05f8-492a-8cc0-1c08edb18cad",
"service_token_id": "327b303e-d0aa-4898-91f9-05f6cc34e2f7",
"trigger": {"calendar": "test@gmail.com"
},
"logic": {"execute": [{"@type": "condition",
"id": "string.include",
"conditionVersionId": "2266fbbd-23ea-4ae7-8306-96f879c9f6ea",
"conditionTarget": {"@type": "reference",
"category": "source",
"path": ["trigger",
"data",
"summary"
]
},
"input": {"keyword": "test"
}
},
{"@type": "action",
"id": "event.quick.create",
"actionVersionId": "10278d84-61d7-4ba1-85dd-d17262590410",
"input": {"service_token_id": "327b303e-d0aa-4898-91f9-05f6cc34e2f7",
"service_version_id": {"@type": "reference",
"category": "source",
"path": ["service_version_id"
]
},
"calendar": "test@gmail.com",
"text": "test"
}
}
]
}
}

Response samples

200

Content type

application/json

{"id": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf",
"version_id": "1be79b21-487f-4cee-a744-261566077859"
}

Delete user automation by id

path Parameters

api_version required	string Example: v1 Interactor API Version.
automation_id required	string Example: e343bfea-06b6-4da2-a8f8-2bb57e135eaf Automation ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get user automation by id

path Parameters

api_version required	string Example: v1 Interactor API Version.
automation_id required	string Example: e343bfea-06b6-4da2-a8f8-2bb57e135eaf Automation ID.

Responses

Response samples

200

Content type

application/json

{"enabled": true,
"id": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf",
"name": "test automation",
"status": "active",
"group_id": "test_group",
"user_id": "user-0000-0000-0000-000000000000",
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"platform_id": "interactor",
"default_version_id": "1be79b21-487f-4cee-a744-261566077859",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00",
"automation_versions": [{"id": "1be79b21-487f-4cee-a744-261566077859",
"name": "0.0.0",
"target": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf",
"logic": {"execute": [{"@type": "condition",
"conditionTarget": {"@type": "reference",
"category": "source",
"path": ["trigger",
"data",
"summary"
]
},
"conditionVersionId": "2266fbbd-23ea-4ae7-8306-96f879c9f6ea",
"id": "string.include",
"input": {"keyword": "test"
}
},
{"@type": "action",
"actionVersionId": "10278d84-61d7-4ba1-85dd-d17262590410",
"id": "event.quick.create",
"input": {"calendar": "test@gmail.com",
"service_token_id": "327b303e-d0aa-4898-91f9-05f6cc34e2f7",
"service_version_id": {"@type": "reference",
"category": "source",
"path": ["service_version_id"
]
},
"text": "test"
}
}
]
},
"trigger_version_id": "9a236faa-05f8-492a-8cc0-1c08edb18cad",
"automation_id": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf",
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"service_token_id": "327b303e-d0aa-4898-91f9-05f6cc34e2f7",
"trigger": {"calendar": "test@gmail.com"
},
"trigger_create_output": "{\"id\":\"e343bfea-06b6-4da2-a8f8-2bb57e135eaf\",\"resourceId\":\"C7csN2UfMRh-f-rJ6bjJdbguddA\"}",
"subscription_id": "{\"id\":\"e343bfea-06b6-4da2-a8f8-2bb57e135eaf\",\"resourceId\":\"C7csN2UfMRh-f-rJ6bjJdbguddA\"}",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}
]
}

Update automation details

path Parameters

api_version required	string Example: v1 Interactor API Version.
automation_id required	string Example: e343bfea-06b6-4da2-a8f8-2bb57e135eaf Automation ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
status	string
group_id	string
user_id	string
created_by	string
updated_by	string
platform_id	string
default_version_id	string
inserted_at	string
updated_at	string
enabled	boolean

Responses

Request samples

Payload

Content type

application/json

{"name": "updated name"
}

Get user automation versions

path Parameters

api_version required	string Example: v1 Interactor API Version.
automation_id required	string Example: e343bfea-06b6-4da2-a8f8-2bb57e135eaf Automation ID.

Responses

Response samples

200

Content type

application/json

[{"id": "1be79b21-487f-4cee-a744-261566077859",
"name": "0.0.0",
"target": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf",
"logic": {"execute": [{"@type": "condition",
"conditionTarget": {"@type": "reference",
"category": "source",
"path": ["trigger",
"data",
"summary"
]
},
"conditionVersionId": "2266fbbd-23ea-4ae7-8306-96f879c9f6ea",
"id": "string.include",
"input": {"keyword": "test"
}
},
{"@type": "action",
"actionVersionId": "10278d84-61d7-4ba1-85dd-d17262590410",
"id": "event.quick.create",
"input": {"calendar": "test@gmail.com",
"service_token_id": "327b303e-d0aa-4898-91f9-05f6cc34e2f7",
"service_version_id": {"@type": "reference",
"category": "source",
"path": ["service_version_id"
]
},
"text": "test"
}
}
]
},
"trigger_version_id": "9a236faa-05f8-492a-8cc0-1c08edb18cad",
"automation_id": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf",
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"service_token_id": "327b303e-d0aa-4898-91f9-05f6cc34e2f7",
"trigger": {"calendar": "test@gmail.com"
},
"trigger_create_output": "{\"id\":\"e343bfea-06b6-4da2-a8f8-2bb57e135eaf\",\"resourceId\":\"C7csN2UfMRh-f-rJ6bjJdbguddA\"}",
"subscription_id": "{\"id\":\"e343bfea-06b6-4da2-a8f8-2bb57e135eaf\",\"resourceId\":\"C7csN2UfMRh-f-rJ6bjJdbguddA\"}",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}
]

Create new user automation version for a given user id

path Parameters

api_version required	string Example: v1 Interactor API Version.
automation_id required	string Example: e343bfea-06b6-4da2-a8f8-2bb57e135eaf Automation ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
target	string
logic	object (logic)
trigger_version_id	string
automation_id	string
created_by	string
updated_by	string
service_token_id	string
trigger	object (automationTrigger)
trigger_create_output	string
subscription_id	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"name": 1,
"logic": {"execute": {"@type": "flow",
"operation": "return",
"value": 123
}
}
}

Response samples

200

Content type

application/json

{"id": "402e11f0-5554-4b8e-975c-b74d4675d40f"
}

Delete user automation version by id

path Parameters

api_version required	string Example: v1 Interactor API Version.
automation_id required	string Example: e343bfea-06b6-4da2-a8f8-2bb57e135eaf Automation ID.
automation_version_id required	string Example: 1be79b21-487f-4cee-a744-261566077859 Automation Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get user automation version by id

path Parameters

api_version required	string Example: v1 Interactor API Version.
automation_id required	string Example: e343bfea-06b6-4da2-a8f8-2bb57e135eaf Automation ID.
automation_version_id required	string Example: 1be79b21-487f-4cee-a744-261566077859 Automation Version ID.

Responses

Response samples

200

Content type

application/json

{"id": "1be79b21-487f-4cee-a744-261566077859",
"name": "0.0.0",
"target": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf",
"logic": {"execute": [{"@type": "condition",
"conditionTarget": {"@type": "reference",
"category": "source",
"path": ["trigger",
"data",
"summary"
]
},
"conditionVersionId": "2266fbbd-23ea-4ae7-8306-96f879c9f6ea",
"id": "string.include",
"input": {"keyword": "test"
}
},
{"@type": "action",
"actionVersionId": "10278d84-61d7-4ba1-85dd-d17262590410",
"id": "event.quick.create",
"input": {"calendar": "test@gmail.com",
"service_token_id": "327b303e-d0aa-4898-91f9-05f6cc34e2f7",
"service_version_id": {"@type": "reference",
"category": "source",
"path": ["service_version_id"
]
},
"text": "test"
}
}
]
},
"trigger_version_id": "9a236faa-05f8-492a-8cc0-1c08edb18cad",
"automation_id": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf",
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"service_token_id": "327b303e-d0aa-4898-91f9-05f6cc34e2f7",
"trigger": {"calendar": "test@gmail.com"
},
"trigger_create_output": "{\"id\":\"e343bfea-06b6-4da2-a8f8-2bb57e135eaf\",\"resourceId\":\"C7csN2UfMRh-f-rJ6bjJdbguddA\"}",
"subscription_id": "{\"id\":\"e343bfea-06b6-4da2-a8f8-2bb57e135eaf\",\"resourceId\":\"C7csN2UfMRh-f-rJ6bjJdbguddA\"}",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}

Update automation version details

path Parameters

api_version required	string Example: v1 Interactor API Version.
automation_id required	string Example: e343bfea-06b6-4da2-a8f8-2bb57e135eaf Automation ID.
automation_version_id required	string Example: 1be79b21-487f-4cee-a744-261566077859 Automation Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
target	string
logic	object (logic)
trigger_version_id	string
automation_id	string
created_by	string
updated_by	string
service_token_id	string
trigger	object (automationTrigger)
trigger_create_output	string
subscription_id	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"trigger": {"calendar": "test2@gmail.com"
}
}

Execute automation manualy

path Parameters

api_version required	string Example: v1 Interactor API Version.
automation_id required	string Example: e343bfea-06b6-4da2-a8f8-2bb57e135eaf Automation ID.
automation_version_id required	string Example: 1be79b21-487f-4cee-a744-261566077859 Automation Version ID.

Request Body schema: application/json

object

Responses

Request samples

Payload

Content type

application/json

{"input": {"test-input": "test"
}
}

Response samples

200

Content type

application/json

{"input": {"test-input": "test"
},
"output": "test-output"
}

Get services

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

Responses

Request samples

Curl

curl --location 'http://localhost:1290/v1/service' \
--header 'api_key: default'

Response samples

200

Content type

application/json

[{"enabled": true,
"id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"name": "googlecalendar",
"type": "0",
"created_by": "my_user",
"updated_by": "my_user",
"platform_id": "interactor",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00",
"sharing": "none",
"icon": "1",
"display_order": 100
}
]

Create a new service

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
type	string
created_by	string
updated_by	string
platform_id	string
inserted_at	string
updated_at	string
sharing	string
icon	string
display_order	string
enabled	string

Responses

Request samples

Payload

Content type

application/json

{"name": "MY_SERVICE",
"platform_id": "interactor",
"enabled": true,
"sharing": "none",
"type": "0"
}

Response samples

200

Content type

application/json

{"id": "e343bfea-06b6-4da2-a8f8-2bb57e135eaf"
}

Delete user service by id

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get user service by id

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Response samples

200

Content type

application/json

{"enabled": true,
"id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"name": "googlecalendar",
"type": "0",
"created_by": "my_user",
"updated_by": "my_user",
"platform_id": "interactor",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00",
"sharing": "none",
"icon": "1",
"display_order": 100
}

Update service details

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
type	string
created_by	string
updated_by	string
platform_id	string
inserted_at	string
updated_at	string
sharing	string
icon	string
display_order	string
enabled	string

Responses

Request samples

Payload

Content type

application/json

{"name": "updated service"
}

Get service webhook url by id

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Response samples

200

Content type

application/json

{"url": "https://proxy.interactor.com:4443/platform/interactor/service/47df3044-5675-4375-afe4-5c53affeb3dc?state=_STATE_"
}

Get actions for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Request samples

Curl

curl --location 'http://localhost:1290/v1/service/a2c8137a-a688-471c-aa45-8cadafda003c/action' \
--header 'api_key: default'

Response samples

200

Content type

application/json

[{"id": "8e169418-71ad-4803-8eb0-425119bf47ae",
"name": "event.create",
"service_id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"created_by": "my_user",
"updated_by": "my_user",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}
]

Create a new action for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
service_id	string
created_by	string
updated_by	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"id": "bfd3b7c6-23e2-493f-a934-b61287b19e57",
"name": "MY_ACTION"
}

Response samples

200

Content type

application/json

{"id": "bfd3b7c6-23e2-493f-a934-b61287b19e57"
}

Delete a single action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.

Responses

Response samples

200

Content type

application/json

{"id": "bfd3b7c6-23e2-493f-a934-b61287b19e57",
"name": "MY_ACTION",
"service_id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"created_by": "my_user",
"updated_by": "my_user",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}

Update a single action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
service_id	string
created_by	string
updated_by	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"name": "updated action"
}

Get versions for a given action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.

Responses

Request samples

Curl

curl --location 'http://localhost:1290/v1/service/a2c8137a-a688-471c-aa45-8cadafda003c/action/00ffe293-db50-40fe-8654-31b2c512fd9d/version' \
--header 'api_key: default'

Response samples

200

Content type

application/json

[{"id": "2043154b-2839-481d-ab6d-f3aea05c3a29",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
},
"schema": { },
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"action_id": "bfd3b7c6-23e2-493f-a934-b61287b19e57",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}
]

Create a new version for a given action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
logic	object (logic)
schema	object (schema)
created_by	string
updated_by	string
action_id	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"id": "2043154b-2839-481d-ab6d-f3aea05c3a29",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
}
}

Response samples

200

Content type

application/json

{"id": "2043154b-2839-481d-ab6d-f3aea05c3a29"
}

Delete a single version of action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.
action_version_id required	string Example: 2043154b-2839-481d-ab6d-f3aea05c3a29 Action Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single version of action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.
action_version_id required	string Example: 2043154b-2839-481d-ab6d-f3aea05c3a29 Action Version ID.

Responses

Response samples

200

Content type

application/json

{"id": "2043154b-2839-481d-ab6d-f3aea05c3a29",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
},
"schema": { },
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"action_id": "bfd3b7c6-23e2-493f-a934-b61287b19e57",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}

Update a single version of action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.
action_version_id required	string Example: 2043154b-2839-481d-ab6d-f3aea05c3a29 Action Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
logic	object (logic)
schema	object (schema)
created_by	string
updated_by	string
action_id	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"name": "2"
}

Execute action version manualy

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.
action_version_id required	string Example: 2043154b-2839-481d-ab6d-f3aea05c3a29 Action Version ID.

Request Body schema: application/json

object

Responses

Request samples

Payload

Content type

application/json

{"input": {"test-input": "test"
}
}

Response samples

200

Content type

application/json

{"input": {"test-input": "test"
},
"output": "test-output"
}

Get conditions for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Response samples

200

Content type

application/json

[{"id": "7b588029-c2d9-4453-8c10-cf6ba0c81fe1",
"name": "array.count.equal",
"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_id": "47df3044-5675-4375-afe4-5c53affeb3dc"
}
]

Create a new condition for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
service_id	string
created_by	string
updated_by	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"id": "809653ba-440f-439a-b8c1-dd98ea1e814e",
"name": "MY_CONDITION"
}

Response samples

200

Content type

application/json

{"id": "809653ba-440f-439a-b8c1-dd98ea1e814e"
}

Delete a single condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.

Responses

Response samples

200

Content type

application/json

{"id": "809653ba-440f-439a-b8c1-dd98ea1e814e",
"name": "MY_CONDITION",
"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_id": "47df3044-5675-4375-afe4-5c53affeb3dc"
}

Update a single condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
service_id	string
created_by	string
updated_by	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"name": "updated condition"
}

Get versions for a given condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.

Responses

Response samples

200

Content type

application/json

[{"id": "7786423f-6150-413a-a396-06c02c709603",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
},
"schema": { },
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"condition_id": "809653ba-440f-439a-b8c1-dd98ea1e814e",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}
]

Create a new version for a given condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
logic	object (logic)
schema	object (schema)
created_by	string
updated_by	string
condition_id	string
inserted_at	string
updated_at	string
condition_target	string

Responses

Request samples

Payload

Content type

application/json

{"id": "7786423f-6150-413a-a396-06c02c709603",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
}
}

Response samples

200

Content type

application/json

{"id": "7786423f-6150-413a-a396-06c02c709603"
}

Delete a single version of condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.
condition_version_id required	string Example: 7786423f-6150-413a-a396-06c02c709603 Condition Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single version of condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.
condition_version_id required	string Example: 7786423f-6150-413a-a396-06c02c709603 Condition Version ID.

Responses

Response samples

200

Content type

application/json

{"id": "7786423f-6150-413a-a396-06c02c709603",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
},
"schema": { },
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"condition_id": "809653ba-440f-439a-b8c1-dd98ea1e814e",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}

Update a single version of condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.
condition_version_id required	string Example: 7786423f-6150-413a-a396-06c02c709603 Condition Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
logic	object (logic)
schema	object (schema)
created_by	string
updated_by	string
condition_id	string
inserted_at	string
updated_at	string
condition_target	string

Responses

Request samples

Payload

Content type

application/json

{"name": "2"
}

Get events for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Response samples

200

Content type

application/json

[{"id": "e48694bc-212e-4c96-8f2a-b26b65cd639e",
"name": "sample.event",
"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_id": "47df3044-5675-4375-afe4-5c53affeb3dc"
}
]

Create a new event for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
service_id	string
created_by	string
updated_by	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"id": "62d4cdc8-8e99-40f9-a6de-851cc377463e",
"name": "MY_EVENT"
}

Response samples

200

Content type

application/json

{"id": "62d4cdc8-8e99-40f9-a6de-851cc377463e"
}

Delete a single event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.

Responses

Response samples

200

Content type

application/json

{"id": "62d4cdc8-8e99-40f9-a6de-851cc377463e",
"name": "MY_EVENT",
"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_id": "47df3044-5675-4375-afe4-5c53affeb3dc"
}

Update a single event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
service_id	string
created_by	string
updated_by	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"name": "updated event"
}

Get versions for a given event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.

Responses

Response samples

200

Content type

application/json

[{"id": "ee971c9c-952f-43d4-b91a-cdad2ef0c12f",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
},
"schema": { },
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"event_id": "62d4cdc8-8e99-40f9-a6de-851cc377463e",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}
]

Create a new version for a given event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
logic	object (logic)
schema	object (schema)
created_by	string
updated_by	string
event_id	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"id": "ee971c9c-952f-43d4-b91a-cdad2ef0c12f",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
}
}

Response samples

200

Content type

application/json

{"id": "ee971c9c-952f-43d4-b91a-cdad2ef0c12f"
}

Delete a single version of event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.
event_version_id required	string Example: ee971c9c-952f-43d4-b91a-cdad2ef0c12f Event Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single version of event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.
event_version_id required	string Example: ee971c9c-952f-43d4-b91a-cdad2ef0c12f Event Version ID.

Responses

Response samples

200

Content type

application/json

{"id": "ee971c9c-952f-43d4-b91a-cdad2ef0c12f",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
},
"schema": { },
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"event_id": "62d4cdc8-8e99-40f9-a6de-851cc377463e",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}

Update a single version of event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.
event_version_id required	string Example: ee971c9c-952f-43d4-b91a-cdad2ef0c12f Event Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
logic	object (logic)
schema	object (schema)
created_by	string
updated_by	string
event_id	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"name": "2"
}

Get triggers for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Response samples

200

Content type

application/json

[{"id": "e48694bc-212e-4c96-8f2a-b26b65cd639e",
"name": "sample.trigger",
"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_id": "47df3044-5675-4375-afe4-5c53affeb3dc"
}
]

Create a new trigger for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
service_id	string
created_by	string
updated_by	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"id": "23c299ad-ac41-46ce-99b1-67c9da3d2f7c",
"name": "MY_TRIGGER"
}

Response samples

200

Content type

application/json

{"id": "23c299ad-ac41-46ce-99b1-67c9da3d2f7c"
}

Delete a single trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.

Responses

Response samples

200

Content type

application/json

{"id": "23c299ad-ac41-46ce-99b1-67c9da3d2f7c",
"name": "MY_TRIGGER",
"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_id": "47df3044-5675-4375-afe4-5c53affeb3dc"
}

Update a single trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
service_id	string
created_by	string
updated_by	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"name": "updated trigger"
}

Get versions for a given trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.

Responses

Response samples

200

Content type

application/json

[{"id": "7613cfd4-633e-44b3-b8b9-5f356b023509",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
},
"schema": { },
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"trigger_id": "23c299ad-ac41-46ce-99b1-67c9da3d2f7c",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}
]

Create a new version for a given trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
logic	object (logic)
schema	object (schema)
created_by	string
updated_by	string
trigger_id	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"id": "7613cfd4-633e-44b3-b8b9-5f356b023509",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
}
}

Response samples

200

Content type

application/json

{"id": "7613cfd4-633e-44b3-b8b9-5f356b023509"
}

Delete a single version of trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.
trigger_version_id required	string Example: 7613cfd4-633e-44b3-b8b9-5f356b023509 Trigger Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single version of trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.
trigger_version_id required	string Example: 7613cfd4-633e-44b3-b8b9-5f356b023509 Trigger Version ID.

Responses

Response samples

200

Content type

application/json

{"id": "7613cfd4-633e-44b3-b8b9-5f356b023509",
"name": "1",
"logic": {"@type": "flow",
"operation": "return",
"value": 123
},
"schema": { },
"created_by": "user-0000-0000-0000-000000000000",
"updated_by": "user-0000-0000-0000-000000000000",
"trigger_id": "23c299ad-ac41-46ce-99b1-67c9da3d2f7c",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00"
}

Update a single version of trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.
trigger_version_id required	string Example: 7613cfd4-633e-44b3-b8b9-5f356b023509 Trigger Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
logic	object (logic)
schema	object (schema)
created_by	string
updated_by	string
trigger_id	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"name": "2"
}

Get trigger webhook url by id

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Response samples

200

Content type

application/json

{"url": "https://proxy.interactor.com:4443/platform/interactor/trigger/1?state=_STATE_"
}

Get versions for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Request samples

Curl

curl --location 'http://localhost:1290/v1/service/42afd2c7-817f-45d5-a747-34507559807c/version' \
--header 'api_key: default'

Response samples

200

Content type

application/json

[{"id": "93ae2586-5ad3-4b18-93dc-3b41aa2f0721",
"name": "1",
"auth": {"accessToken": {"form": {"client_id": {"@type": "reference",
"category": "platformServiceVariable",
"variable": "oauth_client_id"
},
"client_secret": {"@type": "reference",
"category": "platformServiceVariable",
"variable": "oauth_client_secret"
},
"code": {"@type": "reference",
"category": "source",
"path": ["code"
]
},
"grant_type": "authorization_code",
"redirect_uri": {"@type": "reference",
"category": "source",
"path": ["redirect_uri"
]
}
},
"headers": {"accept": "application/json",
"content-type": "application/x-www-form-urlencoded"
},
"method": "post",
"url": "https://oauth2.googleapis.com/token"
},
"authorization": {"method": "get",
"parameter": {"client_id": {"@type": "reference",
"category": "platformServiceVariable",
"variable": "oauth_client_id"
},
"scope": "https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/calendar.readonly https://www.googleapis.com/auth/calendar.events"
},
"url": "https://accounts.google.com/o/oauth2/v2/auth?prompt=consent&access_type=offline&include_granted_scopes=true&response_type=code"
},
"refreshToken": {"form": {"client_id": {"@type": "reference",
"category": "platformServiceVariable",
"variable": "oauth_client_id"
},
"client_secret": {"@type": "reference",
"category": "platformServiceVariable",
"variable": "oauth_client_secret"
},
"grant_type": "refresh_token",
"refresh_token": {"@type": "reference",
"category": "source",
"path": ["refresh_token"
]
}
},
"headers": {"accept": "application/json",
"content-type": "application/x-www-form-urlencoded"
},
"method": "post",
"url": "https://oauth2.googleapis.com/token"
},
"userInfo": {"headers": {"Authorization": ""
},
"method": "get",
"namePath": ["email"
],
"url": "https://www.googleapis.com/oauth2/v3/tokeninfo"
}
},
"variables": {"oauth_client_id": {"schema": {"type": "string"
}
},
"oauth_client_secret": {"schema": {"type": "string"
}
}
},
"inserted_at": "2024-01-01T00:00:00",
"setting": {"webhook": {"input": {"Content type": "application/json",
"Payload URL": {"@type": "reference",
"category": "webhookService"
},
"Secret": {"@type": "reference",
"category": "webhookSecret"
}
},
"type": "automation"
}
},
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"auth_type": "oauthv2"
}
]

Create a new version of service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
auth	object (serviceAuth)
variables	object (serviceVariables)
inserted_at	string
setting	object (serviceSetting)
created_by	string
updated_at	string
updated_by	string
service_id	string
auth_type	string

Responses

Request samples

Payload

Content type

application/json

{"id": "096973e7-7801-40d4-8198-d18f1a3e83ff",
"name": "2"
}

Response samples

200

Content type

application/json

{"id": "096973e7-7801-40d4-8198-d18f1a3e83ff"
}

Delete a single version of service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single version of service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.

Responses

Response samples

200

Content type

application/json

{"id": "096973e7-7801-40d4-8198-d18f1a3e83ff",
"name": "2",
"auth": { },
"variables": { },
"inserted_at": "2024-01-01T00:00:00",
"setting": { },
"created_by": "user-0000-0000-0000-000000000000",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "user-0000-0000-0000-000000000000",
"service_id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"auth_type": ""
}

Update a single version of service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
auth	object (serviceAuth)
variables	object (serviceVariables)
inserted_at	string
setting	object (serviceSetting)
created_by	string
updated_at	string
updated_by	string
service_id	string
auth_type	string

Responses

Request samples

Payload

Content type

application/json

{"name": "11"
}

Get service oauth url by id

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.

Responses

Request samples

Curl

curl --location 'http://localhost:1290/v1/service/cc14ee5f-cd82-4757-a95e-b12d1e9eb8c7/version/42afd2c7-817f-45d5-a747-34507559807c/oauth?sourceId=testSourceId' \
--header 'api_key: default'

Response samples

200

Content type

application/json

"https://accounts.google.com/o/oauth2/v2/auth?prompt=consent&access_type=offline&include_granted_scopes=true&response_type=code&redirect_uri=https%3A%2F%2Fproxy.interactor.com%3A4443%2Fplatform%2Finteractor%2Foauth&state=_STATE_&client_id=_CLIENT_ID_&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fuserinfo.email+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcalendar.readonly+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcalendar.events"

Get action versions for a given service version

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.

Responses

Request samples

Curl

curl --location 'http://localhost:1290/v1/service/a2c8137a-a688-471c-aa45-8cadafda003c/version/42afd2c7-817f-45d5-a747-34507559807c/action?sourceId=testSourceId' \
--header 'api_key: default'

Response samples

200

Content type

application/json

[{"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_version_id": "93ae2586-5ad3-4b18-93dc-3b41aa2f0721",
"action_version_id": "10278d84-61d7-4ba1-85dd-d17262590410"
}
]

Create a new version link for service and action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.
action_version_id required	string Example: 2043154b-2839-481d-ab6d-f3aea05c3a29 Action Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Delete a single version link for service and action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.
action_id required	string Example: bfd3b7c6-23e2-493f-a934-b61287b19e57 Action ID.
action_version_id required	string Example: 2043154b-2839-481d-ab6d-f3aea05c3a29 Action Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get condition versions for a given service version

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.

Responses

Response samples

200

Content type

application/json

[{"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_version_id": "93ae2586-5ad3-4b18-93dc-3b41aa2f0721",
"condition_version_id": "98a85a60-88ed-4540-84fa-2b7468e0bdde"
}
]

Create a new version link for service and condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.
condition_version_id required	string Example: 7786423f-6150-413a-a396-06c02c709603 Condition Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Delete a single version link for service and condition

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.
condition_id required	string Example: 809653ba-440f-439a-b8c1-dd98ea1e814e Condition ID.
condition_version_id required	string Example: 7786423f-6150-413a-a396-06c02c709603 Condition Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get event versions for a given service version

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.

Responses

Response samples

200

Content type

application/json

[{"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_version_id": "93ae2586-5ad3-4b18-93dc-3b41aa2f0721",
"event_version_id": "f45f4914-68bb-467e-911c-85a2d9303a6f"
}
]

Create a new version link for service and event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.
event_version_id required	string Example: ee971c9c-952f-43d4-b91a-cdad2ef0c12f Event Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Delete a single version link for service and event

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.
event_id required	string Example: 62d4cdc8-8e99-40f9-a6de-851cc377463e Event ID.
event_version_id required	string Example: ee971c9c-952f-43d4-b91a-cdad2ef0c12f Event Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get trigger versions for a given service version

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.

Responses

Response samples

200

Content type

application/json

[{"inserted_at": "2024-01-01T00:00:00",
"created_by": "my_user",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "my_user",
"service_version_id": "93ae2586-5ad3-4b18-93dc-3b41aa2f0721",
"trigger_version_id": "200ef94c-8a59-4318-a1b7-89faa96edcd0"
}
]

Create a new version link for service and trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.
trigger_version_id required	string Example: 7613cfd4-633e-44b3-b8b9-5f356b023509 Trigger Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Delete a single version link for service and trigger

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.
trigger_id required	string Example: 23c299ad-ac41-46ce-99b1-67c9da3d2f7c Trigger ID.
trigger_version_id required	string Example: 7613cfd4-633e-44b3-b8b9-5f356b023509 Trigger Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get tokens for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Request samples

Curl

curl --location 'http://localhost:1290/v1/service/a2c8137a-a688-471c-aa45-8cadafda003c/token?sourceId=testSourceId' \
--header 'api_key: default'

Response samples

200

Content type

application/json

[{"id": "327b303e-d0aa-4898-91f9-05f6cc34e2f7",
"code": "_CODE_",
"name": "account@gmail.com",
"type": "oauth",
"token": "_TOKEN_",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00",
"service_url": "",
"service_id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"user_id": "my_user",
"refresh_token": "_REFRESH_TOKEN_",
"token_type": "bearer"
}
]

Create a new token for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
code	string
name	string
type	string
token	string
inserted_at	string
updated_at	string
service_url	string
service_id	string
user_id	string
refresh_token	string
token_type	string

Responses

Request samples

Payload

Content type

application/json

{"id": "c6d6c3e3-b5b3-41d1-9393-54cc79fec492",
"name": "MY_TOKEN"
}

Response samples

200

Content type

application/json

{"id": "c6d6c3e3-b5b3-41d1-9393-54cc79fec492"
}

Delete a single token

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
token_id required	string Example: c6d6c3e3-b5b3-41d1-9393-54cc79fec492 Token ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single token

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
token_id required	string Example: c6d6c3e3-b5b3-41d1-9393-54cc79fec492 Token ID.

Responses

Response samples

200

Content type

application/json

{"id": "8ecef3d6-cee1-49d3-8802-cf6a2e7ad369",
"code": "",
"name": "MY_TOKEN",
"type": "",
"token": "",
"inserted_at": "2024-01-01T00:00:00",
"updated_at": "2024-01-01T00:00:00",
"service_url": "",
"service_id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"user_id": "",
"refresh_token": "",
"token_type": ""
}

Update a single token

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
token_id required	string Example: c6d6c3e3-b5b3-41d1-9393-54cc79fec492 Token ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
code	string
name	string
type	string
token	string
inserted_at	string
updated_at	string
service_url	string
service_id	string
user_id	string
refresh_token	string
token_type	string

Responses

Request samples

Payload

Content type

application/json

{"name": "updated token"
}

execute-action

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_version_id required	string Example: 096973e7-7801-40d4-8198-d18f1a3e83ff Service Version ID.
action_version_id required	string Example: 2043154b-2839-481d-ab6d-f3aea05c3a29 Action Version ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

Schema not provided

Responses

Request samples

Payload
Curl

Content type

application/json

[{"calendar": "testmail@test.com",
"summary": "test"
}
]

Response samples

200

Content type

application/json

[{"input": {"calendar"": "testmail@test.com",
"service_token_id"": "b57201d5-69b7-4d7d-b276-71b107c17d63",
"service_version_id"": "42afd2c7-817f-45d5-a747-34507559807c",
"summary": "test"
},
"output": {"created": "2024-03-27T09:56:22.000Z",
"creator": {"email": "testmail@test.com",
"self": true
},
"end": {"dateTime": "2024-03-27T19:56:22+09:00",
"timeZone": "Asia/Seoul"
},
"etag": "\\3423066764914000\\",
"eventType": "default",
"htmlLink": "https://www.google.com/calendar/event?eid=eid",
"iCalUID": "icaluid@google.com",
"id": "id",
"kind": "calendar#event",
"organizer": {"email": "testmail@test.com",
"self": true
},
"reminders": {"useDefault": true
},
"sequence": 0,
"start": {"dateTime": "2024-03-27T18:56:22+09:00",
"timeZone": "Asia/Seoul"
},
"status": "confirmed",
"summary": "test",
"updated": "2024-03-27T09:56:22.457Z"
}
}
]

Get variables for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

Responses

Response samples

200

Content type

application/json

[{"id": "3d050434-9708-4045-a727-14304e8ea1c7",
"name": "oauth_client_id",
"type": "",
"value": "_OAUTH_CLIENT_ID_",
"inserted_at": "2024-01-01T00:00:00",
"created_by": "user-0000-0000-0000-000000000000",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "user-0000-0000-0000-000000000000",
"service_id": "3e31f412-9336-46bf-9ef9-f0793c878697"
}
]

Create a new variable for a given service

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
type	string
value	string
inserted_at	string
created_by	string
updated_at	string
updated_by	string
service_id	string

Responses

Request samples

Payload

Content type

application/json

{"id": "339453cd-f297-4cda-ae2b-379f2026b3b5",
"name": "MY_VARIABLE"
}

Response samples

200

Content type

application/json

{"id": "339453cd-f297-4cda-ae2b-379f2026b3b5"
}

Delete a single variable

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
variable_id required	string Example: 339453cd-f297-4cda-ae2b-379f2026b3b5 Variable ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single variable

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
variable_id required	string Example: 339453cd-f297-4cda-ae2b-379f2026b3b5 Variable ID.

Responses

Response samples

200

Content type

application/json

{"id": "339453cd-f297-4cda-ae2b-379f2026b3b5",
"name": "MY_VARIABLE",
"type": "",
"value": "",
"inserted_at": "2024-01-01T00:00:00",
"created_by": "user-0000-0000-0000-000000000000",
"updated_at": "2024-01-01T00:00:00",
"updated_by": "user-0000-0000-0000-000000000000",
"service_id": "3e31f412-9336-46bf-9ef9-f0793c878697"
}

Update a single variable

path Parameters

api_version required	string Example: v1 Interactor API Version.
service_id required	string Example: 3e31f412-9336-46bf-9ef9-f0793c878697 Service ID.
variable_id required	string Example: 339453cd-f297-4cda-ae2b-379f2026b3b5 Variable ID.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

id	string
name	string
type	string
value	string
inserted_at	string
created_by	string
updated_at	string
updated_by	string
service_id	string

Responses

Request samples

Payload

Content type

application/json

{"name": "updated variable"
}

Test logic based on given table

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

Request Body schema: application/json

table	string
id	string
record_path	Array of arrays
data	object
source	Array of arrays

Responses

Request samples

Payload

Content type

application/json

Example

test-by-id

{"table": "ActionVersion",
"id": "c769d0d9-aedb-44a8-beb4-ac9295ecbeca",
"data": {"string": "abc",
"pattern": "b",
"replacement": "d"
},
"source": ["execute"
]
}

Response samples

200

Content type

application/json

"adc"

Test notification based on given request

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

Request Body schema: application/json

Schema not provided

Responses

Request samples

Payload

Content type

application/json

{"body": "",
"connection": {"peer": {"ip": "172.21.0.2",
"port": 37114
},
"socket": {"ip": "172.21.0.5",
"port": 8080
}
},
"cookie": { },
"header": {"accept": "*/*",
"accept-encoding": "gzip, deflate, br",
"connection": "close",
"content-length": "0",
"host": "autoflow:8080",
"user-agent": "APIs-Google; (+https://developers.google.com/webmasters/APIs-Google.html)",
"x-goog-channel-expiration": "Mon, 1 Jan 2024 00:00:00 GMT",
"x-goog-channel-id": "0",
"x-goog-channel-token": "",
"x-goog-message-number": "16212",
"x-goog-resource-id": "_GOOGLE_RESOURCE_ID_",
"x-goog-resource-state": "exists",
"x-goog-resource-uri": "https://www.googleapis.com/calendar/v3/calendars/_GOOGLE_CALENDAR_/events?alt=json"
},
"method": "post",
"path": {"platform_id": "interactor"
},
"query": {"state": "_STATE_"
},
"uri": "http://autoflow:8080/platform/interactor/service/3e31f412-9336-46bf-9ef9-f0793c878697?state=_STATE_"
}

Create a new user

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

Request Body schema: application/json

email	string
password	string
name	string
source	string
source_id	string
authorization	string
created_by	string
updated_by	string
confirmed_at	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload
Curl

Content type

application/json

{"id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"name": "my_user"
}

Response samples

200

Content type

application/json

{"id": "3e31f412-9336-46bf-9ef9-f0793c878697"
}

Delete a single user

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Get a single user

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Responses

Response samples

200

Content type

application/json

{"id": "3e31f412-9336-46bf-9ef9-f0793c878697",
"name": "my_user"
}

Update a single user

path Parameters

api_version

required

string

Example: v1

Interactor API Version.

query Parameters

user_id

required

string

Example: user_id=user-0000-0000-0000-000000000000

User ID.

Request Body schema: application/json

email	string
password	string
name	string
source	string
source_id	string
authorization	string
created_by	string
updated_by	string
confirmed_at	string
inserted_at	string
updated_at	string

Responses

Request samples

Payload

Content type

application/json

{"name": "updated user"
}

Get API version

Responses

Response samples

200

Content type

application/json

"0.0.0"