List judge action groups

List action groups owned by judges, with stable group IDs and the selected judge version. Each group runs its actions when the judge result matches its condition, subject to its environments, frequency, and cooldown.

GET/v1/projects/{projectId}/judges/action-groups

Authorization

AuthorizationPersonal API key · headerrequired

Your personal API key from Settings > Personal API Keys, sent as Bearer <key>.

X-Organization-IdOrganization ID · headerrequired

The organization to act in. Copy it with Copy organization ID in the organization menu or the settings sidebar.

Path parameters

projectIdstringrequired

Query parameters

versionstring

default: "production"

Allowed:latestproduction

Responses

200

Response for status 200

action_groupsobject[]required

Show properties

Array of object

judge_idstringrequired

judge_namestringrequired

judge_major_versionnumberrequired

judge_minor_versionnumberrequired

action_groupobjectrequired

Show properties

idstringrequired

min length 1

namestringrequired

Action group display name; an empty string uses Action group 1, 2, etc.

enabledbooleanrequired

environment_namesstring[]required

Empty runs the group in every environment

whenobjectrequired

Judge result that runs the group. Categorical groups run when the result is any listed output name.

Show properties

One of:

object

kindstringrequired

object

kindstringrequired

valuebooleanrequired

object

kindstringrequired

valuesstring[]required

min items 1

object

kindstringrequired

operatorstringrequired

Allowed:ltlteeqgtegt

valuenumberrequired

frequencyobjectrequired

Show properties

countintegerrequired

min 1 · max 9007199254740991

window_secondsintegerrequired

min 1 · max 9007199254740991

cooldown_secondsintegerrequired

min 0 · max 9007199254740991

actionsobject[]required

Show properties

Array of object

One of:

object

idstringrequired

min length 1

enabledbooleanrequired

typestringrequired

configobjectrequired

Show properties

urlstringrequired

min length 1

secretstringrequired

min length 1

object

idstringrequired

min length 1

enabledbooleanrequired

typestringrequired

configobjectrequired

Show properties

email_addressstringrequired

min length 1

object

idstringrequired

min length 1

enabledbooleanrequired

typestringrequired

configobjectrequired

Show properties

team_idstring

min length 1

channel_idstring

min length 1

messagestring

custom_attribute_keysstring[]

object

idstringrequired

min length 1

enabledbooleanrequired

typestringrequired

configobjectrequired

Show properties

dataset_idstringrequired

min length 1

object

idstringrequired

min length 1

enabledbooleanrequired

typestringrequired

configobjectrequired

Show properties

judge_idsstring[]required

min items 1

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Personal API keyOrganization IDRemember on this deviceInclude my values in samples

Parameters

projectIdpath*versionquery

Request

curl -X GET 'https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/judges/action-groups' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'X-Organization-Id: YOUR_ORGANIZATION_ID' \
  -H 'Accept: application/json'

const response = await fetch("https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/judges/action-groups", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "X-Organization-Id": "YOUR_ORGANIZATION_ID",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/judges/action-groups",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Organization-Id": "YOUR_ORGANIZATION_ID",
        "Accept": "application/json"
    },
)

Response

{
  "action_groups": [
    {
      "judge_id": "string",
      "judge_name": "string",
      "judge_major_version": 0,
      "judge_minor_version": 0,
      "action_group": {
        "id": "string",
        "name": "string",
        "enabled": true,
        "environment_names": [
          "string"
        ],
        "when": {
          "kind": "any"
        },
        "frequency": {
          "count": 1,
          "window_seconds": 1
        },
        "cooldown_seconds": 0,
        "actions": [
          {
            "id": "string",
            "enabled": true,
            "type": "webhook",
            "config": {
              "url": "string",
              "secret": "string"
            }
          }
        ]
      }
    }
  ]
}