Object Configuration API Overview

Learn more about the Object Configuration API.

The Object Configuration API allows configuration to calculation and selection concepts in the production version of your tenant. Configuration API requests (PUT requests) are applied in a new project that gets automatically published to production. Additionally, any configuration done through the Object Configuration API overwrites the concept's existing configuration. For example, if the API request body does not include any dimension members, all existing dimension members mapped to that concept will be removed.

Let's say that you're using the Object Configuration API to map Levels 4 and 5 to the isHighPerformer selection concept. Let's say that the production version of isHighPerformer already has Level 3 configured. Your API request might look like the following.

Copy

curl -X PUT --url https://jupiter.api.visier.io/v1/admin/selection-concepts/8c03c1b0-42e7-4d0e-8f64-1fee64962739/configure \
-H "apikey:12345" \
-H "Cookie:VisierASIDToken=abc123" \
-H "Content-Type: application/json" \
-d ‘{
    "analyticObjectFiltersToMap": [{
        "analyticObjectUuid": "2a4463ee-6dd0-452a-bbb1-4fe10e48d411", 
        "dimensions": [{
            "dimensionId": "84008324-22ac-4418-ac6c-c3001a44d9c1", 
            "dimensionMembers": [{
                "dimensionMember": ["Level 5"]
            }, {
                "dimensionMember": ["Level 4"]
            }] 
        }]
    }] 
}’

In the above sample request, only Levels 4 and 5 are configured to isHighPerformer (8c03c1b0-42e7-4d0e-8f64-1fee64962739). If the API request is successful, isHighPerformer has Level 4 and Level 5, but not Level 3. If you want to keep Level 3 configured to isHighPerformer, your API request might look like the following.

Copy

curl -X PUT --url https://jupiter.api.visier.io/v1/admin/selection-concepts/8c03c1b0-42e7-4d0e-8f64-1fee64962739/configure \
-H "apikey:12345" \
-H "Cookie:VisierASIDToken=abc123" \
-H "Content-Type: application/json" \
-d ‘{
    "analyticObjectFiltersToMap": [{
        "analyticObjectUuid": "2a4463ee-6dd0-452a-bbb1-4fe10e48d411", 
        "dimensions": [{
            "dimensionId": "84008324-22ac-4418-ac6c-c3001a44d9c1", 
            "dimensionMembers": [{
                "dimensionMember": ["Level 5"]
            }, {
                "dimensionMember": ["Level 4"]
            }, {
                "dimensionMember": ["Level 3"]
            }] 
        }]
    }] 
}’