Create Evaluation Group

curl --request POST \
  --url https://api.egp.scale.com/v5/evaluation-groups \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "evaluation_ids": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ],
  "description": "<string>",
  "metadata": {
    "project": "Q4-2025",
    "team": "ml-eval"
  },
  "row_identifiers": {
    "eval-123": "user_id",
    "eval-456": "customer_id"
  }
}
'

{
  "id": "<string>",
  "tags": [
    "<string>"
  ],
  "name": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "account_id": "<string>",
  "object": "evaluation_group",
  "description": "<string>",
  "metadata": {},
  "deleted_at": "2023-11-07T05:31:56Z",
  "members": [
    {
      "id": "<string>",
      "evaluation_group_id": "<string>",
      "evaluation_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "object": "evaluation_group.member",
      "evaluation_name": "<string>",
      "evaluation_tags": [
        "<string>"
      ],
      "evaluation_created_at": "2023-11-07T05:31:56Z",
      "deleted_at": "2023-11-07T05:31:56Z"
    }
  ],
  "row_identifiers": [
    {
      "evaluation_id": "<string>",
      "column_name": "<string>",
      "object": "evaluation_group.row_identifier"
    }
  ]
}

Evaluation Groups

Create Evaluation Group

Create a new evaluation group bundling one or more existing evaluations.

The request must list at least one evaluation ID, and duplicate IDs are rejected. Every listed evaluation is validated for existence and account access before the group is created; an unknown or inaccessible evaluation ID fails the whole request with a 400 rather than creating a partial group. The named evaluations are added as group members in the same transaction, and any supplied row_identifiers (an evaluation_id-to-column-name mapping used for cross-dataset joins) are persisted alongside them, ignoring entries for evaluation IDs not in the group. The returned group includes its members enriched with each evaluation’s name, tags, and creation time. Unlike the PUT and PATCH update endpoints, creation does not trigger any dashboard-widget recomputation.

POST

/

v5

/

evaluation-groups

Create Evaluation Group

curl --request POST \
  --url https://api.egp.scale.com/v5/evaluation-groups \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "evaluation_ids": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ],
  "description": "<string>",
  "metadata": {
    "project": "Q4-2025",
    "team": "ml-eval"
  },
  "row_identifiers": {
    "eval-123": "user_id",
    "eval-456": "customer_id"
  }
}
'

{
  "id": "<string>",
  "tags": [
    "<string>"
  ],
  "name": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "account_id": "<string>",
  "object": "evaluation_group",
  "description": "<string>",
  "metadata": {},
  "deleted_at": "2023-11-07T05:31:56Z",
  "members": [
    {
      "id": "<string>",
      "evaluation_group_id": "<string>",
      "evaluation_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "object": "evaluation_group.member",
      "evaluation_name": "<string>",
      "evaluation_tags": [
        "<string>"
      ],
      "evaluation_created_at": "2023-11-07T05:31:56Z",
      "deleted_at": "2023-11-07T05:31:56Z"
    }
  ],
  "row_identifiers": [
    {
      "evaluation_id": "<string>",
      "column_name": "<string>",
      "object": "evaluation_group.row_identifier"
    }
  ]
}

Authorizations

x-api-key

string

header

required

Headers

x-selected-account-id

string | null

Body

application/json

Request model for creating an evaluation group

name

string

required

Name of the evaluation group

Maximum string length: 128

evaluation_ids

string[]

required

List of evaluation IDs to include in the group

Minimum array length: 1

tags

string[]

The tags associated with the entity

description

string

Optional description

metadata

Metadata · object

Optional metadata key-value pairs

Example:

{ "project": "Q4-2025", "team": "ml-eval" }

row_identifiers

Row Identifiers · object

Optional mapping of evaluation_id to column name for cross-dataset joins

Show child attributes

Example:

{
  "eval-123": "user_id",
  "eval-456": "customer_id"
}

Response

Successful Response

Response model for evaluation group

id

string

required

Unique identifier of the evaluation group

tags

string[]

required

The tags associated with the entity

name

string

required

Name of the evaluation group

created_at

string<date-time>

required

When the group was created

account_id

string

required

Account that owns this evaluation group

object

string

default:evaluation_group

Allowed value: "evaluation_group"

description

string

Optional description

metadata

Metadata · object

Optional metadata key-value pairs

deleted_at

string<date-time>

When the group was soft-deleted

members

Members · object[]

Evaluation members in this group. Populated with 'members' view.

Show child attributes

row_identifiers

Row Identifiers · object[]

Row identifier mappings. Populated with 'row_identifiers' view.

Show child attributes

List Evaluation Groups Get Evaluation Group

⌘I