/icws/{sessionId}/configuration/dnis-mappings

GET

/icws/{sessionId}/configuration/dnis-mappings

Returns the global dnisMappings settings.
Feature Version
configuration 1

Request

Parameters
Type
Name
Comments
Header
ININ-ICWS-CSRF-Token

Required

The ININ session token necessary for all calls that require a security or user context.

    Header
    Cookie

    Required

    The session cookie. With the exception of the connection request, all requests must provide a session cookie.

      Template
      sessionId

      Required

      The ININ session ID necessary for all calls that require a security or user context.

        Query
        select

        A comma-delimited list of fields to include in the query. If no fields are specified, then only the ID of the items is returned.

        Example: select=extension,defaultWorkstation

        One can also specify that all of the properties should be returned by using the '*' wildcard value. This is a shortcut for specifying all of the properties' names in the parameter.

        The selected properties with a NULL value will not be returned to conserve the Interaction Center server's resources.

          Query
          rightsFilter
          The security right to use when filtering the results.

          Default value: admin

          Options:

          • view
          • admin

          Response

          200 - OK
          The dnisMappings resource is included in the response.
          dnisMappings
          Represents the dnisMappings configuration object.
          Property
          Value
          Comments
          dnis
          String

          Required

          id
          String

          Required

          The unique identifier used to reference this configuration object.
          displayName
          String
          The display name of this configuration object.

          This property can be null.

          uri
          Uri
          A URI used to access this configuration object.
          user
          0
          workgroup
          1
          station
          2
          description
          String

          This property can be null.

          none
          0
          replace
          1
          prefix
          2
          extension
          String
          The extension of the Workgroup, Station, or User assigned to this rounting table entry. This property is read-only and will be ignored by the server in POST and PUT operations.

          This property can be null.

          400 - Bad Request
          Invalid parameter value was specified.

          Error Responses

          Error Identifier
          Error Type
          Error Description
          error.request.invalidRepresentation.malformed
          Type: urn:inin.com:common:error
          The request representation object was malformed.
          Feature Version
          configuration 2
          error.request.configuration.get.selectAll
          Type: urn:inin.com:common:error
          Combining the wildcard (*) and one or more specific properties in one request is not supported.
          Feature Version
          configuration 2
          error.request.configuration.getObject
          Type: urn:inin.com:configuration:getObjectError
          One or more of the properties in the 'rightsFilter' or 'select' query parameters are not supported.
          Feature Version
          configuration 2
          error
          Provides additional detail for an error.
          Property
          Value
          Comments

          Multiple options:

          The value can be assigned any of the following options.
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          __type
          "urn:inin.com:configuration:getObjectError"

          Required

          The JSON type representing this option.
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          select
          List [Unbounded]: String
          The properties in the select query parameter that are not supported by the object type.

          Property type documentation:

          Represents a collection of strings.

          rightsFilter
          String
          The properties in the rightsFilter query parameter that are not supported by the object type.
          403 - Forbidden
          Not authorized to retrieve this resource.
          error
          Provides additional detail for an error.
          Property
          Value
          Comments
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          404 - Not Found
          The dnisMappings does not exist.
          error
          Provides additional detail for an error.
          Property
          Value
          Comments
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          500 - Internal Server Error
          An unexpected error occurred while processing the request.

          Error Responses

          Error Identifier
          Error Type
          Error Description
          error.request.internalServerError
          Type: urn:inin.com:common:error
          The server encountered an unexpected, internal error.
          Feature Version
          configuration 2
          error.request.timeout
          Type: urn:inin.com:common:error
          The request timed out.
          Feature Version
          configuration 2
          error
          Provides additional detail for an error.
          Property
          Value
          Comments
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          401 - Unauthorized
          The specified session token is missing, invalid, or has expired.
          Parameters
          Type
          Name
          Comments
          Header
          WWW-Authenticate

          Required

          Indicates that the client needs to authenticate using a custom ICWS scheme, which supports a realm of type ICWS and a location which is the URL at which the client can authenticate. A typical example would be the following.

          WWW-Authenticate: ICWS realm="ICWS" location="/ICWS/connection"

            error
            Provides additional detail for an error.
            Property
            Value
            Comments
            errorId
            String
            The error identifier that describes the current error.
            message
            String

            Required

            A message that describes the current error.
            410 - Gone
            This resource has been deprecated and removed from the API.
            error
            Provides additional detail for an error.
            Property
            Value
            Comments
            errorId
            String
            The error identifier that describes the current error.
            message
            String

            Required

            A message that describes the current error.

            PUT

            /icws/{sessionId}/configuration/dnis-mappings

            Updates the global dnisMappings settings.
            Feature Version
            configuration 1

            Request

            Parameters
            Type
            Name
            Comments
            Header
            ININ-ICWS-CSRF-Token

            Required

            The ININ session token necessary for all calls that require a security or user context.

              Header
              Cookie

              Required

              The session cookie. With the exception of the connection request, all requests must provide a session cookie.

                Template
                sessionId

                Required

                The ININ session ID necessary for all calls that require a security or user context.

                  Representations
                  dnisMappings
                  Represents the dnisMappings configuration object.
                  Property
                  Value
                  Comments
                  dnis
                  String

                  Required

                  id
                  String

                  Required

                  The unique identifier used to reference this configuration object.
                  displayName
                  String
                  The display name of this configuration object.

                  This property can be null.

                  uri
                  Uri
                  A URI used to access this configuration object.
                  user
                  0
                  workgroup
                  1
                  station
                  2
                  description
                  String

                  This property can be null.

                  none
                  0
                  replace
                  1
                  prefix
                  2
                  extension
                  String
                  The extension of the Workgroup, Station, or User assigned to this rounting table entry. This property is read-only and will be ignored by the server in POST and PUT operations.

                  This property can be null.

                  Response

                  200 - OK
                  The dnisMappings has been updated.
                  updateOperationResult
                  Represents the result from a put or post operation.
                  Property
                  Value
                  Comments
                  id
                  String

                  Required

                  The unique identifier used to reference this configuration object.
                  uri
                  Uri
                  A URI used to access this configuration object.
                  setOK
                  0
                  Setting the license succeeded. This value is never sent.
                  setWarningExceedsThreshold
                  1
                  Indicates that a dynamic license was found with an assignment count that exceeds it's assignable and or concurrent thresholds. As this is only a warning to indicate problems, the license in the request was set successfully.
                  setErrorExceedsThreshold
                  2
                  Indicates that a dynamic license being set exceed it's assignable or concurrent thresholds and was not set as a result. This can be returned for any license assigned to a user or station as part of setting it's licenses because they are all checked for problems as part of the operation.
                  setWarningMissingQualifiers
                  3
                  Indicates that the ACD media level in the request did not have a corresponding set of ACD media types and the default value(s) for the level were set as a result.
                  400 - Bad Request
                  Invalid request was provided. If validation errors exist, they will be returned in the response.

                  Error Responses

                  Error Identifier
                  Error Type
                  Error Description
                  error.request.invalidRepresentation.malformed
                  Type: urn:inin.com:common:error
                  The request representation object was malformed.
                  error.request.configuration.update
                  Type: urn:inin.com:configuration:configurationError
                  The request has one or more license or validation errors in it.
                  error
                  Provides additional detail for an error.
                  Property
                  Value
                  Comments

                  Multiple options:

                  The value can be assigned any of the following options.
                  errorId
                  String
                  The error identifier that describes the current error.
                  message
                  String

                  Required

                  A message that describes the current error.
                  __type
                  "urn:inin.com:configuration:configurationError"

                  Required

                  The JSON type representing this option.
                  errorId
                  String
                  The error identifier that describes the current error.
                  message
                  String

                  Required

                  A message that describes the current error.
                  unknownValidator
                  0
                  Unknown validator.
                  uniqueInstanceId
                  1
                  The value must be unique across objects of this type.
                  existingInstanceId
                  2
                  The value must represent a valid ID for a configured instance.
                  existingAttributeValue
                  3
                  The value must match a configured instance.
                  requiredValue
                  4
                  The value must be specified.
                  range
                  5
                  The value must be in the correct range.
                  stringLength
                  6
                  The value must have the correct number of characters.
                  regex
                  7
                  The value must be formatted correctly.
                  validValues
                  9
                  The value is not from the allowed set.
                  collectionCount
                  10
                  The value must have the correct number of items.
                  collectionItemValidator
                  11
                  One or more items failed to validate successfully.
                  validatorGroup
                  12
                  The value is not from the allowed set.
                  validFormat
                  13
                  The value is not in a valid format.
                  uniqueAttributeValue
                  14
                  The value must be unique across attributes of this type.
                  requiredAttribute
                  15
                  The attribute must be specified.
                  acgTreeValidator
                  16
                  The Acg Tree either could not be verified or found, or the Acg Tree depth is not supported.
                  pronunciationValidator
                  17
                  The value is not a valid pronunciation format.
                  wordValidator
                  18
                  The value must be a valid word.
                  rangeFloat
                  19
                  The value must be in the correct range.
                  existingAttendantProfile
                  20
                  The value must match a configured attendant profile instance.
                  extension
                  21
                  The value must not be an existing extension.
                  workstationsSharedAppearanceID
                  22
                  Unknown validator.
                  multipleOf
                  23
                  The value is not a valid multiple value.
                  invalidCharacters
                  24
                  The value contains invalid characters.
                  existingExtension
                  25
                  The value must be an existing extension.
                  existingInstanceIdWithAttributeValue
                  26
                  The value must represent a valid ID for a configured instance.
                  characterDelimitedValue
                  27
                  The value contains invalid characters.
                  analyzerKeywordCount
                  28
                  The number of keywords assigned to the keyword set makes the configuration exceed the maximum number of supported keywords.
                  workgroupAnalyzerKeywordCount
                  29
                  The number of keywords assigned to the workgroup is greater than the maximum number of supported keywords.
                  endDateTimeValidator
                  30
                  The end date or time of a schedule must be greater than or equal to the start date or time.
                  propertyNotApplicable
                  31
                  This property is not applicable with the current configuration.
                  invalidMailboxFolder
                  32
                  The value is not a valid mailbox.
                  unsupportedManufacturer
                  33
                  The provided phone manufacturer is unsupported.
                  unsupportedModel
                  34
                  The provided phone model is unsupported.
                  audioProtocol
                  35
                  An Audio protocol value of SRTP is only supported when the Registration Group for the configuration object has one or more registered lines with a Transport Protocol of TLS.
                  recorderPolicyAnalyzerKeywordCount
                  36
                  The number of keywords assigned to the keyword set makes at least one Recorder Policy exceed the maximum number of supported keywords.
                  referenceCount
                  37
                  The number of reference to this object is exceeding the maximum limit.
                  Feature Version
                  configuration 8
                  wrapUpStatusTimeout
                  38
                  The values of WrapUpStatus or WrapUpTimeout are not valid.
                  Feature Version
                  configuration 8
                  attributeExistence
                  39
                  One or more required attributes was not specified and/or one or more required absent attributes was specifed.
                  Feature Version
                  configuration 8
                  otherAttributeValue
                  40
                  The otherAttributeValue property is expected to have (or not have) a value.
                  Feature Version
                  configuration 8
                  networkAdapter
                  41
                  The network adapter is invalid.
                  Feature Version
                  configuration 8
                  integerComparisonValidator
                  42
                  The integer comparison failed validation based on the comparison type selected.
                  Feature Version
                  configuration 8
                  timeZoneValidator
                  43
                  The time zone is invalid.
                  Feature Version
                  configuration 8
                  existingLanguageValues
                  44
                  The values provided must be languages supported by PureConnect.
                  Feature Version
                  configuration 8
                  characterDelimitedKVPairs
                  45
                  The character delimited key-value pairs are invalid.
                  Feature Version
                  configuration 8
                  objectValidationErrorMutuallyExclusive
                  46
                  Two configuration values are mutually exclusive.
                  Feature Version
                  configuration 10
                  propertyName
                  String

                  Required

                  propertyValue
                  String

                  Required

                  setOK
                  0
                  Setting the license succeeded. This value is never sent.
                  setWarningExceedsThreshold
                  1
                  Indicates that a dynamic license was found with an assignment count that exceeds it's assignable and or concurrent thresholds. As this is only a warning to indicate problems, the license in the request was set successfully.
                  setErrorExceedsThreshold
                  2
                  Indicates that a dynamic license being set exceed it's assignable or concurrent thresholds and was not set as a result. This can be returned for any license assigned to a user or station as part of setting it's licenses because they are all checked for problems as part of the operation.
                  setWarningMissingQualifiers
                  3
                  Indicates that the ACD media level in the request did not have a corresponding set of ACD media types and the default value(s) for the level were set as a result.
                  403 - Forbidden
                  Not authorized to update this resource.
                  error
                  Provides additional detail for an error.
                  Property
                  Value
                  Comments
                  errorId
                  String
                  The error identifier that describes the current error.
                  message
                  String

                  Required

                  A message that describes the current error.
                  404 - Not Found
                  The dnisMappings does not exist.
                  error
                  Provides additional detail for an error.
                  Property
                  Value
                  Comments
                  errorId
                  String
                  The error identifier that describes the current error.
                  message
                  String

                  Required

                  A message that describes the current error.
                  500 - Internal Server Error
                  An unexpected error occurred while processing the request.

                  Error Responses

                  Error Identifier
                  Error Type
                  Error Description
                  error.request.internalServerError
                  Type: urn:inin.com:common:error
                  The server encountered an unexpected, internal error.
                  Feature Version
                  configuration 2
                  error.request.timeout
                  Type: urn:inin.com:common:error
                  The request timed out.
                  Feature Version
                  configuration 2
                  error
                  Provides additional detail for an error.
                  Property
                  Value
                  Comments
                  errorId
                  String
                  The error identifier that describes the current error.
                  message
                  String

                  Required

                  A message that describes the current error.
                  401 - Unauthorized
                  The specified session token is missing, invalid, or has expired.
                  Parameters
                  Type
                  Name
                  Comments
                  Header
                  WWW-Authenticate

                  Required

                  Indicates that the client needs to authenticate using a custom ICWS scheme, which supports a realm of type ICWS and a location which is the URL at which the client can authenticate. A typical example would be the following.

                  WWW-Authenticate: ICWS realm="ICWS" location="/ICWS/connection"

                    error
                    Provides additional detail for an error.
                    Property
                    Value
                    Comments
                    errorId
                    String
                    The error identifier that describes the current error.
                    message
                    String

                    Required

                    A message that describes the current error.
                    410 - Gone
                    This resource has been deprecated and removed from the API.
                    error
                    Provides additional detail for an error.
                    Property
                    Value
                    Comments
                    errorId
                    String
                    The error identifier that describes the current error.
                    message
                    String

                    Required

                    A message that describes the current error.