Requires any of the roles: | SystemAdministrator, Manager, Customer |
GET | /flows |
---|
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
AccountIds | query | List<string> | No | Filter by accounts |
CustomerIds | query | List<string> | No | The IDs of the customers whose flows you want to retrieve |
NameFilter | query | string | No | Filter by name |
TagIds | query | List<string> | No | The list of tag IDs to filter by (must contain all) |
Role | query | FlowRoles? | No | List flows by specific role |
IncludeNodes | query | bool | No | Exclude nodes |
NodeTypeFilter | query | string | No | Node Type Filter |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Page | form | int | No | The page of data to retrieve |
All | form | bool | No | If you want all objects to be returned. This should be used with care |
CountPerPage | form | int | No | The number per page to retrieve |
SpecificIds | form | List<string> | No | Specific IDs |
SortField | form | string | No | Specify a sort field |
SortOrder | form | SortOrders | No | Specify a sort order |
SimplifiedPaging | form | bool | No | Disables total / page counts - improves performance. Returns only data. If there is no more data, Items will be empty array |
Ascend | |
Descend |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Name | form | string | No | The name of this flow |
Roles | form | List<FlowRoles> | No | The roles that this flow has |
Description | form | string | No | What this flow does |
Notes | form | string | No | Any notes for this flow |
AccountId | form | string | No | The ID of the account associated with the flow |
AccountName | form | string | No | The name of the account associated with the flow |
CustomerId | form | string | No | The ID of the customer this flow is associated with |
CustomerName | form | string | No | The name of the customer this flow is associated with |
CustomerBreadcrumb | form | List<CustomerBreadcrumb> | No | The breadcrumb to the flow for this endpoint |
Nodes | form | List<FlowNode> | No | The nodes in this flow |
Parameters | form | List<FlowParameter> | No | The flow's parameters |
Exits | form | List<FlowExit> | No | The flow's exits |
UI | form | FlowUI | No | The UI data for the flow |
Tags | form | List<Tag> | No | The list of tags for this flow |
NodeCount | form | int | No | The number of nodes in this flow |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | The ID of the object |
DateCreated | form | string | No | The date the object was created |
DateLastModified | form | string | No | The date the object was last modified |
CreatedBy | form | string | No | The user that created this object |
LastModifiedBy | form | string | No | The user that last modified this object |
UI | |
Reference | |
PhoneNumberRouting | |
UserDialOut | |
FaxNumberRouting |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | |
Name | form | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | The ID of this node. Must be unique within the flow but can be anything |
IsStartNode | form | bool | No | Is this the starting node for the flow. Only one node can have this set |
Name | form | string | No | The name of the node, descriptive to be used as a reminder in the GUI |
Spec | form | FlowNodeSpec | No | The specification for the node |
UI | form | FlowNodeUI | No | The UI data for the node |
Parameters | form | NodeParameterMap | No | The data for this node. These will be POST'd to the endpoint when it is called. |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Name | form | string | No | The name of this node |
Description | form | string | No | A description of this node |
IconClass | form | string | No | Icon class for this node (FontAwesome) |
TypeName | form | string | No | The type name for this node |
Category | form | FlowNodeCategories | No | The category this node should be grouped under |
Url | form | string | No | The URL where this node is located |
DataType | form | DataType | No | The data type for this node |
DocumentationUrl | form | string | No | URL for documentation for this node |
RestrictToChannels | form | List<FlowChannels> | No | The channels that this node is restricted to |
General | |
Voice | |
Logic | |
DateAndTime | |
Audio | |
Messaging | |
Assistant | |
Flows | |
Fax | |
Network | |
Cookies | |
CallCenter | |
Intelligence |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
TypeName | form | string | No | |
Fields | form | List<DataField> | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | |
Name | form | string | No | |
Type | form | ValueTypes | No | |
UIHint | form | UIHints | No | |
UITab | form | string | No | |
IsAsync | form | bool | No | |
DisableBinding | form | bool | No | |
StructType | form | DataType | No | |
ListType | form | DataType | No | |
Description | form | string | No | |
PossibleValues | form | List<string> | No | |
IsOutput | form | bool | No | |
CustomFieldValuesUrl | form | string | No | |
DefaultValue | form | Value | No | |
TransitionNameFormat | form | string | No | |
Uniqueness | form | DataFieldUniqueness | No | |
VoiceOnly | form | bool | No | |
ConditionalVisibilityField | form | string | No | |
ConditionalVisibilityValue | form | string | No | |
NoEvalTemplate | form | bool | No | |
UserMode | form | UserDataFieldModes | No | |
AnyValueType | form | bool | No |
NotSpecified | |
String | |
Boolean | |
Number | |
List | |
Struct | |
Transition | |
Custom | |
Date | |
AudioFile | |
TimeZoneId | |
PhoneNumber | |
User | |
Endpoint | |
Time | |
File | |
FaxNumber | |
EmailAccount | |
Customer | |
Flow | |
Team | |
FlowReference | |
Integration | |
Assistant |
None | |
LargeText | |
InlineForm | |
Password | |
InlineStruct |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
BoolValue | form | bool? | No | |
StringValue | form | string | No | |
NumberValue | form | double? | No | |
ListValue | form | List<Struct> | No | |
StructValue | form | Struct | No |
NotUnique | |
Unique | |
UniqueToCustomer |
Hidden | |
ReadOnly | |
ReadWrite |
Voice | |
Chat | |
Fax |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
X | form | double | No | The X position of the node |
Y | form | double | No | The Y position of the node |
Notes | form | string | No | Notes for this node |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | |
Type | form | ValueTypes | No | |
Source | form | ValueSources | No | |
IsAsync | form | bool | No | |
ReferenceId | form | string | No | |
Value | form | Value | No | |
NoEvalTemplate | form | bool | No | |
ListParameters | form | List<NodeParameterMap> | No | |
StructParameters | form | NodeParameterMap | No | |
IsOutput | form | bool | No | |
Expression | form | string | No | |
ListType | form | DataType | No |
Value | |
Flow | |
System | |
Customer | |
Session | |
Endpoint | |
Expression | |
User |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
IsPublic | form | bool | No | |
IsKnob | form | bool | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | The unique ID for this exit |
Name | form | string | No | The name of this exit |
UI | form | FlowNodeUI | No | The UI for the exit |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
SelectedNode | form | string | No | |
CanvasX | form | double | No | |
CanvasY | form | double | No | |
CanvasZoom | form | double | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | |
Name | form | string | No | |
Color | form | TagColors | No |
Magenta | |
Red | |
Volcano | |
Orange | |
Gold | |
Lime | |
Green | |
Cyan | |
Blue | |
GeekBlue | |
Purple |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Items | form | List<AccountInfo> | No | The items |
TotalCount | form | int | No | The total number of items |
TotalPages | form | int | No | The total number of pages |
HasMorePages | form | bool | No | Are there more pages of items? Used with simplified paging |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Name | form | string | No | The name of this account |
ParentAccountId | form | string | No | The ID of this account's parent |
TwilioAccountSid | form | string | No | The twilio account SID |
AncestorIds | form | List<string> | No | The ancestors of this account. Useful for breadcrumbs |
MaxPhoneNumbers | form | int | No | The max number of phone numbers this account can have |
IsBYOA | form | bool | No | This account is BYOA |
TrustHubProfileSid | form | string | No | TrustHub Profile Sid |
LogoId | form | string | No | The ID of the logo file |
LogoUri | form | string | No | The URI of the logo file |
BillingSettings | form | BillingSettings | No | The billing settings for this account |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Base | form | BillingItem | No | |
LocalNumbers | form | BillingItem | No | |
TollFreeNumbers | form | BillingItem | No | |
InboundVoiceCalls | form | BillingItem | No | |
OutboundVoiceCalls | form | BillingItem | No | |
InboundFaxes | form | BillingItem | No | |
OutboundFaxes | form | BillingItem | No | |
InboundSmsMessages | form | BillingItem | No | |
OutboundSmsMessages | form | BillingItem | No | |
AIInsights | form | BillingItem | No | |
AILiveMinutes | form | BillingItem | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
BaseCost | form | double | No | |
RawUnitMultiplier | form | double | No | |
UnitCost | form | double | No | |
Allowance | form | int | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /flows HTTP/1.1 Host: team.evovoice.io Accept: application/xml
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <ListResponseOfFlowInfoM153aFo_P xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api"> <HasMorePages>false</HasMorePages> <Items xmlns:d2p1="http://schemas.datacontract.org/2004/07/Voice.Api.Flows"> <d2p1:FlowInfo> <CreatedBy>String</CreatedBy> <DateCreated>String</DateCreated> <DateLastModified>String</DateLastModified> <Id>String</Id> <LastModifiedBy>String</LastModifiedBy> <d2p1:AccountId>String</d2p1:AccountId> <d2p1:AccountName>String</d2p1:AccountName> <d2p1:CustomerBreadcrumb xmlns:d4p1="http://schemas.datacontract.org/2004/07/Voice.Api.Customers"> <d4p1:CustomerBreadcrumb> <d4p1:Id>String</d4p1:Id> <d4p1:Name>String</d4p1:Name> </d4p1:CustomerBreadcrumb> </d2p1:CustomerBreadcrumb> <d2p1:CustomerId>String</d2p1:CustomerId> <d2p1:CustomerName>String</d2p1:CustomerName> <d2p1:Description>String</d2p1:Description> <d2p1:Exits> <d2p1:FlowExit> <d2p1:Id>String</d2p1:Id> <d2p1:Name>String</d2p1:Name> <d2p1:UI> <d2p1:Notes>String</d2p1:Notes> <d2p1:X>0</d2p1:X> <d2p1:Y>0</d2p1:Y> </d2p1:UI> </d2p1:FlowExit> </d2p1:Exits> <d2p1:Name>String</d2p1:Name> <d2p1:NodeCount>0</d2p1:NodeCount> <d2p1:Nodes> <d2p1:FlowNode> <d2p1:Id>String</d2p1:Id> <d2p1:IsStartNode>false</d2p1:IsStartNode> <d2p1:Name>String</d2p1:Name> <d2p1:Parameters xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d6p1:KeyValueOfstringNodeParameteripFhVFNS> <d6p1:Key>String</d6p1:Key> <d6p1:Value i:nil="true" /> </d6p1:KeyValueOfstringNodeParameteripFhVFNS> </d2p1:Parameters> <d2p1:Spec> <d2p1:Category>General</d2p1:Category> <d2p1:DataType xmlns:d7p1="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data" i:nil="true" /> <d2p1:Description>String</d2p1:Description> <d2p1:DocumentationUrl>String</d2p1:DocumentationUrl> <d2p1:IconClass>String</d2p1:IconClass> <d2p1:Name>String</d2p1:Name> <d2p1:RestrictToChannels> <d2p1:FlowChannels>Voice</d2p1:FlowChannels> </d2p1:RestrictToChannels> <d2p1:TypeName>String</d2p1:TypeName> <d2p1:Url>String</d2p1:Url> </d2p1:Spec> <d2p1:UI> <d2p1:Notes>String</d2p1:Notes> <d2p1:X>0</d2p1:X> <d2p1:Y>0</d2p1:Y> </d2p1:UI> </d2p1:FlowNode> </d2p1:Nodes> <d2p1:Notes>String</d2p1:Notes> <d2p1:Parameters> <d2p1:FlowParameter> <AnyValueType xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">false</AnyValueType> <ConditionalVisibilityField xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">String</ConditionalVisibilityField> <ConditionalVisibilityValue xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">String</ConditionalVisibilityValue> <CustomFieldValuesUrl xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">String</CustomFieldValuesUrl> <DefaultValue xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data"> <BoolValue>false</BoolValue> <ListValue xmlns:d7p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d7p1:ArrayOfKeyValueOfstringValue8Ahp2kgT i:nil="true" /> </ListValue> <NumberValue>0</NumberValue> <StringValue>String</StringValue> <StructValue xmlns:d7p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" /> </DefaultValue> <Description xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">String</Description> <DisableBinding xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">false</DisableBinding> <Id xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">String</Id> <IsAsync xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">false</IsAsync> <IsOutput xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">false</IsOutput> <ListType i:nil="true" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data" /> <Name xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">String</Name> <NoEvalTemplate xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">false</NoEvalTemplate> <PossibleValues xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data"> <d6p1:string>String</d6p1:string> </PossibleValues> <StructType i:nil="true" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data" /> <TransitionNameFormat xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">String</TransitionNameFormat> <Type xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">NotSpecified</Type> <UIHint xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">None</UIHint> <UITab xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">String</UITab> <Uniqueness xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">NotUnique</Uniqueness> <UserMode xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">Hidden</UserMode> <VoiceOnly xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">false</VoiceOnly> <d2p1:IsKnob>false</d2p1:IsKnob> <d2p1:IsPublic>false</d2p1:IsPublic> </d2p1:FlowParameter> </d2p1:Parameters> <d2p1:Roles> <d2p1:FlowRoles>UI</d2p1:FlowRoles> </d2p1:Roles> <d2p1:Tags xmlns:d4p1="http://schemas.datacontract.org/2004/07/Voice.Api.Settings"> <d4p1:Tag> <d4p1:Color>Magenta</d4p1:Color> <d4p1:Id>String</d4p1:Id> <d4p1:Name>String</d4p1:Name> </d4p1:Tag> </d2p1:Tags> <d2p1:UI> <d2p1:CanvasX>0</d2p1:CanvasX> <d2p1:CanvasY>0</d2p1:CanvasY> <d2p1:CanvasZoom>0</d2p1:CanvasZoom> <d2p1:SelectedNode>String</d2p1:SelectedNode> </d2p1:UI> </d2p1:FlowInfo> </Items> <TotalCount>0</TotalCount> <TotalPages>0</TotalPages> </ListResponseOfFlowInfoM153aFo_P>