GET
/
v1
/
groups
/
{group_name}
Get a policy group by name
curl --request GET \
  --url https://api.app.chainloop.dev/v1/groups/{group_name} \
  --header 'Authorization: Bearer <token>'
{
  "version_references": [
    {
      "digest": "digest",
      "created_at": "2000-01-23T04:56:07.000Z"
    },
    {
      "digest": "digest",
      "created_at": "2000-01-23T04:56:07.000Z"
    }
  ],
  "inputs_json_schema": "inputs_json_schema",
  "organization_id": "organization_id",
  "builtin": true,
  "digest": "digest",
  "raw": {
    "format": "FORMAT_UNSPECIFIED",
    "body": "body"
  },
  "organization_name": "organization_name",
  "group": {
    "version_references": [
      {
        "digest": "digest",
        "created_at": "2000-01-23T04:56:07.000Z"
      },
      {
        "digest": "digest",
        "created_at": "2000-01-23T04:56:07.000Z"
      }
    ],
    "attestation": [
      {
        "with": {
          "key": "with"
        },
        "ref": "ref"
      },
      {
        "with": {
          "key": "with"
        },
        "ref": "ref"
      }
    ],
    "materials": [
      {
        "name": "name",
        "policies": [
          {
            "with": {
              "key": "with"
            },
            "ref": "ref"
          },
          {
            "with": {
              "key": "with"
            },
            "ref": "ref"
          }
        ],
        "type": "type"
      },
      {
        "name": "name",
        "policies": [
          {
            "with": {
              "key": "with"
            },
            "ref": "ref"
          },
          {
            "with": {
              "key": "with"
            },
            "ref": "ref"
          }
        ],
        "type": "type"
      }
    ],
    "raw_group": {
      "format": "FORMAT_UNSPECIFIED",
      "body": "body"
    },
    "builtin": true,
    "organization_id": "organization_id",
    "digest": "digest",
    "name": "name",
    "description": "description",
    "organization_name": "organization_name",
    "category": "category",
    "latest": true
  },
  "latest": true
}

Authorizations

Authorization
string
header
required

Bearer token for authentication

Path Parameters

group_name
string
required

The name of the policy group to retrieve

Query Parameters

digest
string

if set, it will return the policy with the given digest otherwise it will return the latest version

If set, returns the policy group with the given digest; otherwise returns the latest version

organization_name
string

Organization owning this policy group (empty for best effort fallback)

Organization owning this policy group (empty for best effort fallback)

Response

200
application/json

A successful response.

Response containing a policy group and its metadata