Fetch configuration

GET /v1/Configuration

Configuration for a Flex instance

Query parameters

  • UiVersion string

    The Pinned UI version of the Configuration resource to fetch.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account that created the Configuration resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • date_created string(date-time) | null

      The date and time in GMT when the Configuration resource was created specified in ISO 8601 format.

    • date_updated string(date-time) | null

      The date and time in GMT when the Configuration resource was last updated specified in ISO 8601 format.

    • attributes

      An object that contains application-specific data.

    • status string

      The status of the Flex onboarding. Can be: ok, inprogress,notstarted.

      Values are ok, inprogress, or notstarted.

    • taskrouter_workspace_sid string | null

      The SID of the TaskRouter Workspace.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WS[0-9a-fA-F]{32}$.

    • taskrouter_target_workflow_sid string | null

      The SID of the TaskRouter target Workflow.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WW[0-9a-fA-F]{32}$.

    • taskrouter_target_taskqueue_sid string | null

      The SID of the TaskRouter Target TaskQueue.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WQ[0-9a-fA-F]{32}$.

    • taskrouter_taskqueues array | null

      The list of TaskRouter TaskQueues.

    • taskrouter_skills array | null

      The Skill description for TaskRouter workers.

    • taskrouter_worker_channels

      The TaskRouter default channel capacities and availability for workers.

    • taskrouter_worker_attributes

      The TaskRouter Worker attributes.

    • taskrouter_offline_activity_sid string | null

      The TaskRouter SID of the offline activity.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WA[0-9a-fA-F]{32}$.

    • runtime_domain string | null

      The URL where the Flex instance is hosted.

    • messaging_service_instance_sid string | null

      The SID of the Messaging service instance.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^MG[0-9a-fA-F]{32}$.

    • chat_service_instance_sid string | null

      The SID of the chat service this user belongs to.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.

    • flex_service_instance_sid string | null

      The SID of the Flex service instance.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.

    • flex_instance_sid string | null

      The SID of the Flex instance.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^GO[0-9a-fA-F]{32}$.

    • ui_language string | null

      The primary language of the Flex UI.

    • ui_attributes

      The object that describes Flex UI characteristics and settings.

    • ui_dependencies

      The object that defines the NPM packages and versions to be used in Hosted Flex.

    • ui_version string | null

      The Pinned UI version.

    • service_version string | null

      The Flex Service version.

    • call_recording_enabled boolean | null

      Whether call recording is enabled.

    • call_recording_webhook_url string | null

      The call recording webhook URL.

    • crm_enabled boolean | null

      Whether CRM is present for Flex.

    • crm_type string | null

      The CRM type.

    • crm_callback_url string | null

      The CRM Callback URL.

    • crm_fallback_url string | null

      The CRM Fallback URL.

    • crm_attributes

      An object that contains the CRM attributes.

    • public_attributes

      The list of public attributes, which are visible to unauthenticated clients.

    • plugin_service_enabled boolean | null

      Whether the plugin service enabled.

    • plugin_service_attributes

      The plugin service attributes.

    • integrations array | null

      A list of objects that contain the configurations for the Integrations supported in this configuration.

    • outbound_call_flows

      The list of outbound call flows.

    • serverless_service_sids array[string] | null

      The list of serverless service SIDs.

      Minimum length of each is 34, maximum length of each is 34. Format of each should match the following pattern: ^ZS[0-9a-fA-F]{32}$.

    • queue_stats_configuration

      Configurable parameters for Queues Statistics.

    • notifications

      Configurable parameters for Notifications.

    • markdown

      Configurable parameters for Markdown.

    • url string(uri) | null

      The absolute URL of the Configuration resource.

    • flex_insights_hr

      Object with enabled/disabled flag with list of workspaces.

    • flex_insights_drilldown boolean | null

      Setting this to true will redirect Flex UI to the URL set in flex_url

    • flex_url string | null

      URL to redirect to in case drilldown is enabled.

    • channel_configs array | null

      Settings for different limits for Flex Conversations channels attachments.

    • debugger_integration

      Configurable parameters for Debugger Integration.

    • flex_ui_status_report

      Configurable parameters for Flex UI Status report.

    • agent_conv_end_methods

      Agent conversation end methods.

    • citrix_voice_vdi

      Citrix voice vdi configuration and settings.

    • offline_config

      Presence and presence ttl configuration

GET /v1/Configuration
curl \
 --request GET 'https://flex-api.twilio.com/v1/Configuration' \
 --user "username:password"
Response examples (200)
{
  "url": "https://flex-api.twilio.com/v1/Configuration",
  "status": "ok",
  "crm_type": "custom",
  "flex_url": "https://flex.twilio.com",
  "markdown": {
    "mode": "readOnly",
    "enabled": false
  },
  "attributes": {
    "main_attribute": "some_attribute"
  },
  "ui_version": "1.0",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "crm_enabled": true,
  "ui_language": "en",
  "date_created": "2016-08-01T22:10:40Z",
  "date_updated": "2016-08-01T22:10:40Z",
  "integrations": [
    {
      "logo": "logo1",
      "name": "twilio",
      "type": "http",
      "active": true,
      "author": "somebody1",
      "config": "{\"callback\":\"twilio.com/cb\",\"allowed_methods\":[\"GET\",\"POST\"]}"
    },
    {
      "name": "twilio-stage",
      "type": "http",
      "active": false,
      "config": "{\"callback\":\"twilio.com/cb\",\"allowed_methods\":[\"GET\",\"POST\"]}"
    }
  ],
  "notifications": {
    "mode": "whenNotInFocus",
    "enabled": true
  },
  "ui_attributes": {},
  "crm_attributes": {
    "crm_attribute": "some_crm"
  },
  "offline_config": {
    "presence": true,
    "presence_ttl": 30
  },
  "runtime_domain": "https://flex.twilio.com",
  "channel_configs": [
    {
      "address_type": "sms",
      "cbm_attachments": {
        "enabled": true,
        "max_file_size": 157286400,
        "accepted_extensions": [
          "jpg",
          "jpeg",
          "png",
          "gif",
          "txt",
          "pdf"
        ],
        "max_total_file_size": 157286400,
        "number_of_attachments": 10
      }
    },
    {
      "address_type": "whatsapp",
      "cbm_attachments": {
        "enabled": true,
        "max_file_size": 16777216,
        "accepted_extensions": [
          "jpg",
          "jpeg",
          "png",
          "amr",
          "mp3",
          "mp4",
          "pdf",
          "heic",
          "oga"
        ],
        "max_total_file_size": 67108864,
        "number_of_attachments": 1
      }
    }
  ],
  "service_version": "1.0",
  "ui_dependencies": {},
  "citrix_voice_vdi": {
    "enabled": false
  },
  "crm_callback_url": "https://crm.com/a",
  "crm_fallback_url": "https://crm.com/b",
  "flex_insights_hr": {
    "advanced_reporting_enabled": true,
    "advanced_reporting_workspaces": [
      {
        "id": "ID_1",
        "timezone": "America/Los_Angeles",
        "workspace_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "id": "ID_2",
        "timezone": "Etc/UTC"
      }
    ]
  },
  "flex_instance_sid": "GOaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "public_attributes": {
    "public": "test"
  },
  "taskrouter_skills": [
    {
      "name": "sales",
      "maximum": 0,
      "minimum": 0,
      "multivalue": false
    },
    {
      "name": "support",
      "maximum": 10,
      "minimum": 0,
      "multivalue": true
    }
  ],
  "outbound_call_flows": {
    "default": {
      "location": "EE",
      "caller_id": "+12345",
      "queue_sid": "WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "workflow_sid": "WWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  },
  "debugger_integration": {
    "enabled": false,
    "console_errors_included": false
  },
  "flex_ui_status_report": {
    "enabled": false
  },
  "taskrouter_taskqueues": [
    {
      "sid": "WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
      "targettable": true
    },
    {
      "sid": "WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaac",
      "targettable": false
    }
  ],
  "agent_conv_end_methods": {
    "enabled": [
      "Leave"
    ],
    "dateUpdated": "2023-08-16T12:22:06.787Z"
  },
  "call_recording_enabled": true,
  "plugin_service_enabled": true,
  "flex_insights_drilldown": true,
  "serverless_service_sids": [
    "ZSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "ZSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab"
  ],
  "taskrouter_workspace_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "chat_service_instance_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "flex_service_instance_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "plugin_service_attributes": {
    "typewriter": "^7.0.1",
    "agent-logger": "^3.10.5"
  },
  "queue_stats_configuration": {
    "default": {
      "reset_time": "00:00",
      "reset_timezone": "America/New_York",
      "service_level_threshold": 20,
      "short_abandoned_threshold": 5
    },
    "queue_configurations": [
      {
        "queue_sid": "WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "reset_time": "01:00",
        "reset_timezone": "Europe/Tallinn"
      },
      {
        "queue_sid": "WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
        "reset_time": "02:00",
        "reset_timezone": "Europe/Paris"
      }
    ],
    "queue_channel_configurations": [
      {
        "queue_sid": "WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "channel_sid": "TCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "service_level_threshold": 10,
        "short_abandoned_threshold": 10
      },
      {
        "queue_sid": "WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
        "channel_sid": "TCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
        "service_level_threshold": 30,
        "short_abandoned_threshold": 15
      }
    ]
  },
  "call_recording_webhook_url": "https://www.example.com/call-recording",
  "taskrouter_worker_channels": {
    "agent": [
      {
        "name": "default",
        "capacity": 1,
        "availability": true
      },
      {
        "name": "voice",
        "capacity": 2,
        "availability": false
      }
    ],
    "supervisor": [
      {
        "name": "default",
        "capacity": 2,
        "availability": true
      }
    ]
  },
  "taskrouter_worker_attributes": {
    "agent": {
      "region": "us-east"
    },
    "supervisor": {
      "region": "us"
    }
  },
  "messaging_service_instance_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "taskrouter_target_workflow_sid": "WWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "taskrouter_offline_activity_sid": "WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "taskrouter_target_taskqueue_sid": "WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}