API

Swagger API details

This is a snapshot of swagger.json file at time of this release. You can also view the 'live' swagger API documentation details for your hosted backend environment by adding /swagger to your backend hostUrl link.

post

Create/Update Experiment User

Body

idstringoptionalExample: user1

groupobjectoptional

workingGroupobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/init' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "user1",
    "group": {
      "schoolId": [
        "school1"
      ],
      "classId": [
        "class1"
      ],
      "instructorId": [
        "instructor1"
      ]
    },
    "workingGroup": {
      "schoolId": "school1",
      "classId": "class1",
      "instructorId": "instructor1"
    }
  }'

200

200

{
  "id": "text",
  "group": {
    "class": [
      {}
    ]
  },
  "workingGroup": {
    "school": "text",
    "class": "text",
    "instructor": "text"
  }
}

Set Group Membership

post

Set group membership for a user

Body

idstringoptionalExample: user1

groupobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/groupmembership' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "user1",
    "group": {
      "schoolId": [
        "school1"
      ],
      "classId": [
        "class1"
      ],
      "instructorId": [
        "instructor1"
      ]
    }
  }'

200

500

200

{
  "id": "text",
  "group": {
    "class": [
      {}
    ]
  },
  "workingGroup": {
    "school": "text",
    "class": "text",
    "instructor": "text"
  }
}

Set Group Membership

patch

Set group membership for a user

Body

idstringoptionalExample: user1

groupobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url '/api/groupmembership' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "user1",
    "group": {
      "schoolId": [
        "school1"
      ],
      "classId": [
        "class1"
      ],
      "instructorId": [
        "instructor1"
      ]
    }
  }'

200

500

200

{
  "id": "text",
  "group": {
    "class": [
      {}
    ]
  },
  "workingGroup": {
    "school": "text",
    "class": "text",
    "instructor": "text"
  }
}

Set Group Membership

post

Set working group for a user

Body

idstringoptionalExample: user1

workingGroupobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/workinggroup' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "user1",
    "workingGroup": {
      "schoolId": "school1",
      "classId": "class1",
      "instructorId": "instructor1"
    }
  }'

200

500

200

{
  "id": "text",
  "group": {
    "class": [
      {}
    ]
  },
  "workingGroup": {
    "school": "text",
    "class": "text",
    "instructor": "text"
  }
}

Set Group Membership

patch

Set working group for a user

Body

idstringoptionalExample: user1

workingGroupobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url '/api/workinggroup' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "user1",
    "workingGroup": {
      "schoolId": "school1",
      "classId": "class1",
      "instructorId": "instructor1"
    }
  }'

200

500

200

{
  "id": "text",
  "group": {
    "class": [
      {}
    ]
  },
  "workingGroup": {
    "school": "text",
    "class": "text",
    "instructor": "text"
  }
}

Set Group Membership

post

Assign a Experiment Point

Body

userIdstringoptionalExample: user1

contextstringoptionalExample: add

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/assign' \
  --header 'Content-Type: application/json' \
  --data '{
    "userId": "user1",
    "context": "add"
  }'

200

404

500

200

[
  {
    "site": "text",
    "target": "text",
    "condition": "text"
  }
]

Experiment Point is Assigned

post

Mark a Experiment Point

Body

userIdstringrequired

sitestringoptional

targetstringoptionalExample: partition1

conditionstringrequiredExample: control

statusstringoptionalExample: condition applied

experimentIdstringoptionalExample: exp1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/mark' \
  --header 'Content-Type: application/json' \
  --data '{
    "userId": "text",
    "site": "text",
    "target": "partition1",
    "condition": "control",
    "status": "condition applied",
    "experimentId": "exp1"
  }'

200

500

200

{
  "id": "text",
  "experimentId": "text",
  "site": "text",
  "target": "text",
  "condition": "text"
}

Experiment Point is Marked

post

Post log data

Body

userIdstringoptional

valueobject[]optional

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/log' \
  --header 'Content-Type: application/json' \
  --data '{
    "userId": "text",
    "value": [
      {
        "userId": "user1",
        "metrics": {
          "attributes": {
            "continuousMetricName": 100,
            "categoricalMetricName": "CATEGORY"
          },
          "groupedMetrics": [
            {
              "groupClass": "workspaceType",
              "groupKey": "workspaceName",
              "attributes": {
                "continuousMetricName": 100,
                "categoricalMetricName": "CATEGORY"
              }
            }
          ]
        }
      }
    ]
  }'

200

500

200

No Content

Log data

get

Get all metrics tracked

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/metric'

200

200

No Content

Get all Metrics

post

Add filter metrics

Body

metricUnitobjectoptional

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/metric' \
  --header 'Content-Type: application/json' \
  --data '{
    "metricUnit": {}
  }'

200

500

200

No Content

Filtered Metrics