Create an Analysis Group

Creating an Analysis Group allows to aggregate Feature Importance for a number of Analyses

Create an Analysis Group

post

Creating an Analysis Group allows to aggregate Feature Importance for a number of Analyses

Authorizations

BearerAuth

Body

application/json

namestring · min: 1Required

Name of an analysis group.

Example: My Analysis Group 1

analysis_idsstring[]Required

The list of existing analysis IDs to include in the group.

Analyses can belong to multiple groups. Analyses must have the same demand type (the interval must match and, for weekly analyses, week_start_day must also be consistent). Every analysis in the group must have the same industry, if set.

Example: ["zRa_kk7MlAA","3aR-gbJp98I","JBb08XsZqAo","q9iX2XqFBxM"]

Responses

201

Successful Response

application/json

400

Invalid analysis_ids

403

Bearer token scope insufficient

422

Validation Error

application/json

post

/v1/beam/analysis-groups

HTTPcURLJavaScriptPython

POST /v1/beam/analysis-groups HTTP/1.1
Host: api.predicthq.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "name": "My Analysis Group 1",
  "analysis_ids": [
    "zRa_kk7MlAA",
    "3aR-gbJp98I",
    "JBb08XsZqAo",
    "q9iX2XqFBxM"
  ],
  "demand_type": {
    "unit_descriptor": "bookings"
  }
}

{
  "group_id": "text"
}

Examples

curl

curl -X POST "https://api.predicthq.com/v1/beam/analysis-groups" \
     -H "Accept: application/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     --data @<(cat <<EOF
    {
        "name": "Analysis Group 1",
        "analysis_ids": [
            "zRa_kk7MlAA",
            "3aR-gbJp98I",
            "JBb08XsZqAo",
            "q9iX2XqFBxM"
        ]
    }
    EOF
    )

python

import requests

response = requests.post(
    url="https://api.predicthq.com/v1/beam/analysis-groups",
    headers={
        "Authorization": "Bearer $ACCESS_TOKEN",
        "Accept": "application/json"
    },
    json={
        "name": "Analysis Group 1",
        "analysis_ids": [
            "zRa_kk7MlAA",
            "3aR-gbJp98I",
            "JBb08XsZqAo",
            "q9iX2XqFBxM",
        ],
    }
)

print(response.json())

Best Practices

Please refer to this guide for the best practices on grouping analyses: Grouping Analyses in Beam

OpenAPI Spec

The OpenAPI spec for Beam API can be found here.