/icws/{sessionId}/configuration/defaults/role

GET

/icws/{sessionId}/configuration/defaults/role

Returns an initialized role object with default values.
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.

        Response

        200 - OK
        An initialized role object with defaults is in the response.
        role
        Represents the role configuration object.
        Property
        Value
        Comments
        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.
        createdDate
        DateTime
        The date this configuration object was created.

        This is a read only property and can not be changed with PUT or POST operations.

        This property can be null.

        name
        String

        Required

        The key identifying this pair.
        value
        String

        Required

        The value of this pair.

        This property can be null.

        lastModifiedDate
        DateTime
        The date this configuration object was last modified.

        This is a read only property and can not be changed with PUT or POST operations.

        This property can be null.

        notes
        String
        The notes for this configuration object.

        This property can be null.

        id
        String
        The unique identifier used to reference this configuration object. The value of this can be null when the grouping of this value is All. Otherwise, it is required.

        This property can be null.

        displayName
        String
        The display name of this configuration object.

        This property can be null.

        uri
        Uri
        A URI used to access this configuration object.

        This property can be null.

        none
        0
        Represents no object type.
        acg
        1
        Represents an ACG object type.
        workgroup
        2
        Represents the workgroup object type.
        lineGroup
        3
        Represents the lineGroup object type.
        feedbackSurveyGroup
        4
        Represents the feedbackSurveyGroup object type.
        all
        0
        Represents all possible ConfigurationIds.
        single
        1
        Represents a single ConfigurationId.
        group
        2
        Represents a grouping of ConfigurationIds where each ConfigurationId is a member of some other Aggregate (Workgroup, Role, ...).
        none
        0
        The property was not inherited.
        Workgroup
        1
        The property was inherited from a Workgroup configuration object.
        Role
        2
        The property was inherited from a Role configuration object.
        DefaultUser
        3
        The property was inherited from the Default User configuration object.
        ClientConfigurationTemplate
        4
        The property was inherited from a Client Configuration Template configuration object.
        actualValue
        Boolean
        The value directly assigned to this configuration object. This value is required for POST and PUT operations.

        This property can be null.

        effectiveValue
        Boolean
        The effective value of this property, from the blending of the actualValue with the inheritedValue. This value is required for GET object and GET object list operations.

        This property can be null.

        inheritedValue
        Boolean
        The actual inherited value, based on this configuration object's membership/inheritance, such as Workgroup, Role, and Default User.

        This property can be null.

        none
        0
        The property was not inherited.
        Workgroup
        1
        The property was inherited from a Workgroup configuration object.
        Role
        2
        The property was inherited from a Role configuration object.
        DefaultUser
        3
        The property was inherited from the Default User configuration object.
        ClientConfigurationTemplate
        4
        The property was inherited from a Client Configuration Template configuration object.
        values
        Boolean

        Required

        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.
        400 - Bad Request
        The request was invalid. This can occur when the message body is malformed or missing required items. This will also occur if a required header or query string parameter is missing or invalid.
        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.