Mapping Global Identifiers to Workspace Identifiers

You can identify Flex Insights (also known as WFO) objects such as reports, metrics, and dashboards, using two types of identifiers:

Workspace Identifier

Also called "object id", URI or local identifier, is a numeric identifier, associated with each object, which is usually displayed in the format /gdc/md/{workspace_id}/obj/5308 or simply as 5308.

  • The Workspace Identifier is local to each Flex Insights workspace, and can't be externally modified.
  • Any object created in a workspace causes this number to increase by 1.

Global Identifiers

Also called external identifiers or simply as identifiers. There are two distinct categories:

  • For the Data Model objects (attributes, facts, etc) the identifier has the following format "attributes.conversation.ivr_path".
  • For the UI objects (reports, metrics, dashboards) the format is a 12 character long alphanumeric, for example, "b08a2c8ca8f4".

An object's Global Identifier can be manipulated under certain conditions, but Flex Insights ensures that the identifier is unique within each individual workspace.

Twilio uses the Global Identifier to ensure that the set of built-in objects with the same Global Identifier have the same definition across all Flex Insights workspaces. Workspace Identifiers, on the other hand, are used to identify specific objects within a workspace.

Here's an example where two reports have different Workspace Identifiers across two Flex Insights workspaces, but the same Global Identifier is the same. Company A and Company B both want to use Q and A Reports. In their individual Flex Insights instances, Company A and B would see the same global identifier (i.e., abPBFm6ZgjV4), but different Workspace Identifiers (e.g., 4309 for Company A, and 51684 for Company B.)

Global Identifiers vs Local Identifiers V3

All the Flex Insights API requests must use the Workspace Identifier, so Flex Insights provides APIs for translating back and forth between Workspace Identifiers and Global Identifiers. This allows you to map your objects to their Global Identifiers using their Workspace Identifier.


Before you can start the mapping between the Global Identifier and the Workspace Identifier, you need the following:

  • a provisioned Flex Insights Workspace
  • the credentials of a user with access to the Flex Insights Workspace
  • The Global Identifier of the object you want to map to a Workspace Identifier
  • REST API client support for cookies that are used to pass authentication tokens

API Authentication

Ensure that you are authenticated against the Flex Insights API by having a valid TT (temporary token). The procedure is detailed at API Authentication

Obtaining the Workspace Id and Global Identifier

You will need:

Workspace ID: Log in to the Analytics Portal and check the URL in the browser address bar. For example:

Workspace id

The workspace ID is the string appearing between the #s=/gdc/projects/ segment and the vertical bar. In this case, the workspace ID is z2nxqtb1r6weuly0iivexz6hu5dathua.

Object Global Identifier: This will most likely be provided by you in some document, external documentation or by Expert Services. The expected format is abJBDYXwfBG1.

Mapping the Identifiers

Now you have everything you need to start mapping your identifiers!

Loading Code Sample...

        Map Global Identifier to Workspace Identifier

        By parsing the response JSON, you can get the Workspace Identifier at identifiers[0]uri

        Multiple identifiers can be mapped in one API call since the identifiers are passed as a JSON list. A list of mappings is returned as a response.

        Loading Code Sample...

              Map Multiple Global Identifiers to Workspace Identifiers

              If you want to map the Workspace Identifier to the Global Identifier, you can call the same API with the parameter uriToIdentifier instead of identifierToUri and provide a list of Workspace Identifiers.

              Loading Code Sample...

                    Map a Global Identifier to a Workspace Identifier

                    Once you get the Workspace Identifier, it is safe to assume that for each Flex Insights workspace, the Workspace Identifier will never change.

                    The Workspace Identifier can be used in any API call (for example, exporting raw data.)

                    Rate this page:

                    Need some help?

                    We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

                    Thank you for your feedback!

                    Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                    Sending your feedback...
                    🎉 Thank you for your feedback!
                    Something went wrong. Please try again.

                    Thanks for your feedback!