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