Evo Voice

<back to all web services

ListFlows

Lists all the flows

Requires Authentication
Requires any of the roles:SystemAdministrator, Manager, Customer
The following routes are available for this service:
GET/flows
using System;
using System.IO;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.Serialization;
using ServiceStack;
using ServiceStack.DataAnnotations;
using Voice.Api.Flows;
using Voice.Api;
using Voice.Api.Customers;
using Voice.Api.Flows.Data;
using Voice.Api.Endpoints;
using Voice.Api.Settings;
using Voice.Api.Accounts;

namespace Voice.Api
{
    public partial class EntityInfo
    {
        ///<summary>
        ///The ID of the object
        ///</summary>
        [ApiMember(Description="The ID of the object")]
        public virtual string Id { get; set; }

        ///<summary>
        ///The date the object was created
        ///</summary>
        [ApiMember(Description="The date the object was created")]
        public virtual string DateCreated { get; set; }

        ///<summary>
        ///The date the object was last modified
        ///</summary>
        [ApiMember(Description="The date the object was last modified")]
        public virtual string DateLastModified { get; set; }

        ///<summary>
        ///The user that created this object
        ///</summary>
        [ApiMember(Description="The user that created this object")]
        public virtual string CreatedBy { get; set; }

        ///<summary>
        ///The user that last modified this object
        ///</summary>
        [ApiMember(Description="The user that last modified this object")]
        public virtual string LastModifiedBy { get; set; }
    }

    public partial class ListRequest<T>
        : IGet
    {
        ///<summary>
        ///The page of data to retrieve
        ///</summary>
        [ApiMember(Description="The page of data to retrieve")]
        public virtual int Page { get; set; }

        ///<summary>
        ///If you want all objects to be returned. This should be used with care
        ///</summary>
        [ApiMember(Description="If you want all objects to be returned. This should be used with care")]
        public virtual bool All { get; set; }

        ///<summary>
        ///The number per page to retrieve
        ///</summary>
        [ApiMember(Description="The number per page to retrieve")]
        public virtual int CountPerPage { get; set; }

        ///<summary>
        ///Specific IDs
        ///</summary>
        [ApiMember(Description="Specific IDs")]
        public virtual List<string> SpecificIds { get; set; }

        ///<summary>
        ///Specify a sort field
        ///</summary>
        [ApiMember(Description="Specify a sort field")]
        public virtual string SortField { get; set; }

        ///<summary>
        ///Specify a sort order
        ///</summary>
        [ApiMember(Description="Specify a sort order")]
        public virtual SortOrders SortOrder { get; set; }

        ///<summary>
        ///Disables total / page counts - improves performance. Returns only data. If there is no more data, Items will be empty array
        ///</summary>
        [ApiMember(Description="Disables total / page counts - improves performance. Returns only data. If there is no more data, Items will be empty array")]
        public virtual bool SimplifiedPaging { get; set; }
    }

    public partial class ListResponse<T>
    {
        ///<summary>
        ///The items
        ///</summary>
        [ApiMember(Description="The items")]
        public virtual List<AccountInfo> Items { get; set; }

        ///<summary>
        ///The total number of items
        ///</summary>
        [ApiMember(Description="The total number of items")]
        public virtual int TotalCount { get; set; }

        ///<summary>
        ///The total number of pages
        ///</summary>
        [ApiMember(Description="The total number of pages")]
        public virtual int TotalPages { get; set; }

        ///<summary>
        ///Are there more pages of items? Used with simplified paging
        ///</summary>
        [ApiMember(Description="Are there more pages of items? Used with simplified paging")]
        public virtual bool HasMorePages { get; set; }
    }

    public enum SortOrders
    {
        Ascend,
        Descend,
    }

}

namespace Voice.Api.Accounts
{
    public partial class AccountInfo
        : EntityInfo
    {
        ///<summary>
        ///The name of this account
        ///</summary>
        [ApiMember(Description="The name of this account")]
        public virtual string Name { get; set; }

        ///<summary>
        ///The ID of this account's parent
        ///</summary>
        [ApiMember(Description="The ID of this account's parent")]
        public virtual string ParentAccountId { get; set; }

        ///<summary>
        ///The twilio account SID
        ///</summary>
        [ApiMember(Description="The twilio account SID")]
        public virtual string TwilioAccountSid { get; set; }

        ///<summary>
        ///The ancestors of this account. Useful for breadcrumbs
        ///</summary>
        [ApiMember(Description="The ancestors of this account. Useful for breadcrumbs")]
        public virtual List<string> AncestorIds { get; set; }

        ///<summary>
        ///The max number of phone numbers this account can have
        ///</summary>
        [ApiMember(Description="The max number of phone numbers this account can have")]
        public virtual int MaxPhoneNumbers { get; set; }

        ///<summary>
        ///This account is BYOA
        ///</summary>
        [ApiMember(Description="This account is BYOA")]
        public virtual bool IsBYOA { get; set; }

        ///<summary>
        ///TrustHub Profile Sid
        ///</summary>
        [ApiMember(Description="TrustHub Profile Sid")]
        public virtual string TrustHubProfileSid { get; set; }

        ///<summary>
        ///The ID of the logo file
        ///</summary>
        [ApiMember(Description="The ID of the logo file")]
        public virtual string LogoId { get; set; }

        ///<summary>
        ///The URI of the logo file
        ///</summary>
        [ApiMember(Description="The URI of the logo file")]
        public virtual string LogoUri { get; set; }

        ///<summary>
        ///The billing settings for this account
        ///</summary>
        [ApiMember(Description="The billing settings for this account")]
        public virtual BillingSettings BillingSettings { get; set; }
    }

    public partial class BillingItem
    {
        public virtual double BaseCost { get; set; }
        public virtual double RawUnitMultiplier { get; set; }
        public virtual double UnitCost { get; set; }
        public virtual int Allowance { get; set; }
    }

    public partial class BillingSettings
    {
        public virtual BillingItem Base { get; set; }
        public virtual BillingItem LocalNumbers { get; set; }
        public virtual BillingItem TollFreeNumbers { get; set; }
        public virtual BillingItem InboundVoiceCalls { get; set; }
        public virtual BillingItem OutboundVoiceCalls { get; set; }
        public virtual BillingItem InboundFaxes { get; set; }
        public virtual BillingItem OutboundFaxes { get; set; }
        public virtual BillingItem InboundSmsMessages { get; set; }
        public virtual BillingItem OutboundSmsMessages { get; set; }
        public virtual BillingItem AIInsights { get; set; }
        public virtual BillingItem AILiveMinutes { get; set; }
    }

}

namespace Voice.Api.Customers
{
    public partial class CustomerBreadcrumb
    {
        public virtual string Id { get; set; }
        public virtual string Name { get; set; }
    }

}

namespace Voice.Api.Endpoints
{
    public enum UserDataFieldModes
    {
        Hidden,
        ReadOnly,
        ReadWrite,
    }

}

namespace Voice.Api.Flows
{
    public enum FlowChannels
    {
        Voice,
        Chat,
        Fax,
    }

    public partial class FlowExit
    {
        ///<summary>
        ///The unique ID for this exit
        ///</summary>
        [ApiMember(Description="The unique ID for this exit")]
        public virtual string Id { get; set; }

        ///<summary>
        ///The name of this exit
        ///</summary>
        [ApiMember(Description="The name of this exit")]
        public virtual string Name { get; set; }

        ///<summary>
        ///The UI for the exit
        ///</summary>
        [ApiMember(Description="The UI for the exit")]
        public virtual FlowNodeUI UI { get; set; }
    }

    public partial class FlowInfo
        : EntityInfo
    {
        ///<summary>
        ///The name of this flow
        ///</summary>
        [ApiMember(Description="The name of this flow")]
        public virtual string Name { get; set; }

        ///<summary>
        ///The roles that this flow has
        ///</summary>
        [ApiMember(Description="The roles that this flow has")]
        public virtual List<FlowRoles> Roles { get; set; }

        ///<summary>
        ///What this flow does
        ///</summary>
        [ApiMember(Description="What this flow does")]
        public virtual string Description { get; set; }

        ///<summary>
        ///Any notes for this flow
        ///</summary>
        [ApiMember(Description="Any notes for this flow")]
        public virtual string Notes { get; set; }

        ///<summary>
        ///The ID of the account associated with the flow
        ///</summary>
        [ApiMember(Description="The ID of the account associated with the flow")]
        public virtual string AccountId { get; set; }

        ///<summary>
        ///The name of the account associated with the flow
        ///</summary>
        [ApiMember(Description="The name of the account associated with the flow")]
        public virtual string AccountName { get; set; }

        ///<summary>
        ///The ID of the customer this flow is associated with
        ///</summary>
        [ApiMember(Description="The ID of the customer this flow is associated with")]
        public virtual string CustomerId { get; set; }

        ///<summary>
        ///The name of the customer this flow is associated with
        ///</summary>
        [ApiMember(Description="The name of the customer this flow is associated with")]
        public virtual string CustomerName { get; set; }

        ///<summary>
        ///The breadcrumb to the flow for this endpoint
        ///</summary>
        [ApiMember(Description="The breadcrumb to the flow for this endpoint")]
        public virtual List<CustomerBreadcrumb> CustomerBreadcrumb { get; set; }

        ///<summary>
        ///The nodes in this flow
        ///</summary>
        [ApiMember(Description="The nodes in this flow")]
        public virtual List<FlowNode> Nodes { get; set; }

        ///<summary>
        ///The flow's parameters
        ///</summary>
        [ApiMember(Description="The flow's parameters")]
        public virtual List<FlowParameter> Parameters { get; set; }

        ///<summary>
        ///The flow's exits
        ///</summary>
        [ApiMember(Description="The flow's exits")]
        public virtual List<FlowExit> Exits { get; set; }

        ///<summary>
        ///The UI data for the flow
        ///</summary>
        [ApiMember(Description="The UI data for the flow")]
        public virtual FlowUI UI { get; set; }

        ///<summary>
        ///The list of tags for this flow
        ///</summary>
        [ApiMember(Description="The list of tags for this flow")]
        public virtual List<Tag> Tags { get; set; }

        ///<summary>
        ///The number of nodes in this flow
        ///</summary>
        [ApiMember(Description="The number of nodes in this flow")]
        public virtual int NodeCount { get; set; }
    }

    public partial class FlowNode
    {
        ///<summary>
        ///The ID of this node. Must be unique within the flow but can be anything
        ///</summary>
        [ApiMember(Description="The ID of this node. Must be unique within the flow but can be anything")]
        public virtual string Id { get; set; }

        ///<summary>
        ///Is this the starting node for the flow. Only one node can have this set
        ///</summary>
        [ApiMember(Description="Is this the starting node for the flow. Only one node can have this set")]
        public virtual bool IsStartNode { get; set; }

        ///<summary>
        ///The name of the node, descriptive to be used as a reminder in the GUI
        ///</summary>
        [ApiMember(Description="The name of the node, descriptive to be used as a reminder in the GUI")]
        public virtual string Name { get; set; }

        ///<summary>
        ///The specification for the node
        ///</summary>
        [ApiMember(Description="The specification for the node")]
        public virtual FlowNodeSpec Spec { get; set; }

        ///<summary>
        ///The UI data for the node
        ///</summary>
        [ApiMember(Description="The UI data for the node")]
        public virtual FlowNodeUI UI { get; set; }

        ///<summary>
        ///The data for this node. These will be POST'd to the endpoint when it is called.
        ///</summary>
        [ApiMember(Description="The data for this node. These will be POST'd to the endpoint when it is called.")]
        public virtual NodeParameterMap Parameters { get; set; }
    }

    public enum FlowNodeCategories
    {
        General,
        Voice,
        Logic,
        DateAndTime,
        Audio,
        Messaging,
        Assistant,
        Flows,
        Fax,
        Network,
        Cookies,
        CallCenter,
        Intelligence,
    }

    public partial class FlowNodeSpec
    {
        ///<summary>
        ///The name of this node
        ///</summary>
        [ApiMember(Description="The name of this node")]
        public virtual string Name { get; set; }

        ///<summary>
        ///A description of this node
        ///</summary>
        [ApiMember(Description="A description of this node")]
        public virtual string Description { get; set; }

        ///<summary>
        ///Icon class for this node (FontAwesome)
        ///</summary>
        [ApiMember(Description="Icon class for this node (FontAwesome)")]
        public virtual string IconClass { get; set; }

        ///<summary>
        ///The type name for this node
        ///</summary>
        [ApiMember(Description="The type name for this node")]
        public virtual string TypeName { get; set; }

        ///<summary>
        ///The category this node should be grouped under
        ///</summary>
        [ApiMember(Description="The category this node should be grouped under")]
        public virtual FlowNodeCategories Category { get; set; }

        ///<summary>
        ///The URL where this node is located
        ///</summary>
        [ApiMember(Description="The URL where this node is located")]
        public virtual string Url { get; set; }

        ///<summary>
        ///The data type for this node
        ///</summary>
        [ApiMember(Description="The data type for this node")]
        public virtual DataType DataType { get; set; }

        ///<summary>
        ///URL for documentation for this node
        ///</summary>
        [ApiMember(Description="URL for documentation for this node")]
        public virtual string DocumentationUrl { get; set; }

        ///<summary>
        ///The channels that this node is restricted to
        ///</summary>
        [ApiMember(Description="The channels that this node is restricted to")]
        public virtual List<FlowChannels> RestrictToChannels { get; set; }
    }

    public partial class FlowNodeUI
    {
        ///<summary>
        ///The X position of the node
        ///</summary>
        [ApiMember(Description="The X position of the node")]
        public virtual double X { get; set; }

        ///<summary>
        ///The Y position of the node
        ///</summary>
        [ApiMember(Description="The Y position of the node")]
        public virtual double Y { get; set; }

        ///<summary>
        ///Notes for this node
        ///</summary>
        [ApiMember(Description="Notes for this node")]
        public virtual string Notes { get; set; }
    }

    public partial class FlowParameter
        : DataField
    {
        public virtual bool IsPublic { get; set; }
        public virtual bool IsKnob { get; set; }
    }

    public enum FlowRoles
    {
        UI,
        Reference,
        PhoneNumberRouting,
        UserDialOut,
        FaxNumberRouting,
    }

    public partial class FlowUI
    {
        public virtual string SelectedNode { get; set; }
        public virtual double CanvasX { get; set; }
        public virtual double CanvasY { get; set; }
        public virtual double CanvasZoom { get; set; }
    }

    ///<summary>
    ///Lists all the flows
    ///</summary>
    [Api(Description="Lists all the flows")]
    public partial class ListFlows
        : ListRequest<FlowInfo>
    {
        ///<summary>
        ///Filter by accounts
        ///</summary>
        [ApiMember(Description="Filter by accounts")]
        public virtual List<string> AccountIds { get; set; }

        ///<summary>
        ///The IDs of the customers whose flows you want to retrieve
        ///</summary>
        [ApiMember(Description="The IDs of the customers whose flows you want to retrieve")]
        public virtual List<string> CustomerIds { get; set; }

        ///<summary>
        ///Filter by name
        ///</summary>
        [ApiMember(Description="Filter by name")]
        public virtual string NameFilter { get; set; }

        ///<summary>
        ///The list of tag IDs to filter by (must contain all)
        ///</summary>
        [ApiMember(Description="The list of tag IDs to filter by (must contain all)")]
        public virtual List<string> TagIds { get; set; }

        ///<summary>
        ///List flows by specific role
        ///</summary>
        [ApiMember(Description="List flows by specific role")]
        public virtual FlowRoles? Role { get; set; }

        ///<summary>
        ///Exclude nodes
        ///</summary>
        [ApiMember(Description="Exclude nodes")]
        public virtual bool IncludeNodes { get; set; }

        ///<summary>
        ///Node Type Filter
        ///</summary>
        [ApiMember(Description="Node Type Filter")]
        public virtual string NodeTypeFilter { get; set; }
    }

    public partial class NodeParameter
    {
        public virtual string Id { get; set; }
        public virtual ValueTypes Type { get; set; }
        public virtual ValueSources Source { get; set; }
        public virtual bool IsAsync { get; set; }
        public virtual string ReferenceId { get; set; }
        public virtual Value Value { get; set; }
        public virtual bool NoEvalTemplate { get; set; }
        public virtual List<NodeParameterMap> ListParameters { get; set; }
        public virtual NodeParameterMap StructParameters { get; set; }
        public virtual bool IsOutput { get; set; }
        public virtual string Expression { get; set; }
        public virtual DataType ListType { get; set; }
    }

    public partial class NodeParameterMap
        : Dictionary<string, NodeParameter>
    {
    }

}

namespace Voice.Api.Flows.Data
{
    public partial class DataField
    {
        public virtual string Id { get; set; }
        public virtual string Name { get; set; }
        public virtual ValueTypes Type { get; set; }
        public virtual UIHints UIHint { get; set; }
        public virtual string UITab { get; set; }
        public virtual bool IsAsync { get; set; }
        public virtual bool DisableBinding { get; set; }
        public virtual DataType StructType { get; set; }
        public virtual DataType ListType { get; set; }
        public virtual string Description { get; set; }
        public virtual List<string> PossibleValues { get; set; }
        public virtual bool IsOutput { get; set; }
        public virtual string CustomFieldValuesUrl { get; set; }
        public virtual Value DefaultValue { get; set; }
        public virtual string TransitionNameFormat { get; set; }
        public virtual DataFieldUniqueness Uniqueness { get; set; }
        public virtual bool VoiceOnly { get; set; }
        public virtual string ConditionalVisibilityField { get; set; }
        public virtual string ConditionalVisibilityValue { get; set; }
        public virtual bool NoEvalTemplate { get; set; }
        public virtual UserDataFieldModes UserMode { get; set; }
        public virtual bool AnyValueType { get; set; }
    }

    public enum DataFieldUniqueness
    {
        NotUnique,
        Unique,
        UniqueToCustomer,
    }

    public partial class DataType
    {
        public virtual string TypeName { get; set; }
        public virtual List<DataField> Fields { get; set; }
    }

    public partial class Struct
        : Dictionary<string, Value>
    {
    }

    public enum UIHints
    {
        None,
        LargeText,
        InlineForm,
        Password,
        InlineStruct,
    }

    public partial class Value
    {
        public virtual bool? BoolValue { get; set; }
        public virtual string StringValue { get; set; }
        public virtual double? NumberValue { get; set; }
        public virtual List<Struct> ListValue { get; set; }
        public virtual Struct StructValue { get; set; }
    }

    public enum ValueSources
    {
        Value,
        Flow,
        System,
        Customer,
        Session,
        Endpoint,
        Expression,
        User,
    }

    public enum ValueTypes
    {
        NotSpecified,
        String,
        Boolean,
        Number,
        List,
        Struct,
        Transition,
        Custom,
        Date,
        AudioFile,
        TimeZoneId,
        PhoneNumber,
        User,
        Endpoint,
        Time,
        File,
        FaxNumber,
        EmailAccount,
        Customer,
        Flow,
        Team,
        FlowReference,
        Integration,
        Assistant,
    }

}

namespace Voice.Api.Settings
{
    public partial class Tag
    {
        public virtual string Id { get; set; }
        public virtual string Name { get; set; }
        public virtual TagColors Color { get; set; }
    }

    public enum TagColors
    {
        Magenta,
        Red,
        Volcano,
        Orange,
        Gold,
        Lime,
        Green,
        Cyan,
        Blue,
        GeekBlue,
        Purple,
    }

}

C# ListFlows DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .other suffix or ?format=other

HTTP + OTHER

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: text/jsonl
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

{"items":[{"name":"String","roles":["UI"],"description":"String","notes":"String","accountId":"String","accountName":"String","customerId":"String","customerName":"String","customerBreadcrumb":[{"id":"String","name":"String"}],"nodes":[{"id":"String","isStartNode":false,"name":"String","spec":{"name":"String","description":"String","iconClass":"String","typeName":"String","category":"General","url":"String","documentationUrl":"String","restrictToChannels":["Voice"]},"ui":{"x":0,"y":0,"notes":"String"},"parameters":{}}],"parameters":[{"isPublic":false,"isKnob":false,"id":"String","name":"String","type":"NotSpecified","uiHint":"None","uiTab":"String","isAsync":false,"disableBinding":false,"description":"String","possibleValues":["String"],"isOutput":false,"customFieldValuesUrl":"String","defaultValue":{"boolValue":false,"stringValue":"String","numberValue":0,"listValue":[null]},"transitionNameFormat":"String","uniqueness":"NotUnique","voiceOnly":false,"conditionalVisibilityField":"String","conditionalVisibilityValue":"String","noEvalTemplate":false,"userMode":"Hidden","anyValueType":false}],"exits":[{"id":"String","name":"String","ui":{"x":0,"y":0,"notes":"String"}}],"ui":{"selectedNode":"String","canvasX":0,"canvasY":0,"canvasZoom":0},"tags":[{"id":"String","name":"String","color":"Magenta"}],"nodeCount":0,"id":"String","dateCreated":"String","dateLastModified":"String","createdBy":"String","lastModifiedBy":"String"}],"totalCount":0,"totalPages":0,"hasMorePages":false}