Read a stack profile summary generation

Reads and decisions use the primary database with fresh permission, credential and source checks. Responses are private/no-store. Summary revisions never create or advance a workload profile version. No request accepts snapshots, approval identities or provider configuration.

GET /api/v1/org/stack-profiles/summary-generations/{generation_id}

Read a stack profile summary generation

Python

import requests

url = "https://platform.ankra.app/api/v1/org/stack-profiles/summary-generations/{generation_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "state": "queued",
  "review_state": "unreviewed",
  "revision": 2,
  "candidate_revision": 1,
  "summary_revision": 1,
  "source_revision": 2,
  "outcomes": [
    {
      "kind": "logging",
      "claims": [
        {
          "fact_id": "<string>",
          "resource_id": "<string>",
          "subject_id": "<string>",
          "statement": "<string>",
          "applicability": "fixed",
          "scope_id": "<string>",
          "condition": {
            "operator": "equals",
            "parameter_id": "<string>",
            "equals": true,
            "children": "<array>"
          }
        }
      ]
    }
  ],
  "selection": [
    {
      "kind": "logging",
      "fact_ids": [
        "<string>"
      ]
    }
  ],
  "facts": [
    {
      "id": "<string>",
      "resource_id": "<string>",
      "predicate": "log_collection",
      "subject_id": "<string>",
      "applicability": "fixed",
      "evidence": [
        {
          "resource_id": "<string>",
          "document": 1,
          "path": "<string>",
          "artifact_digest": "<string>"
        }
      ],
      "enabled": true,
      "count": 1,
      "scope_id": "<string>",
      "condition": {
        "operator": "equals",
        "parameter_id": "<string>",
        "equals": true,
        "children": "<array>"
      }
    }
  ],
  "coverage": [
    {
      "resource_id": "<string>",
      "reason": "unsupported_format"
    }
  ],
  "parameters": [
    {
      "id": "<string>",
      "default": true
    }
  ],
  "error_code": "quota_exceeded"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

generation_id · string<uuid> · required

Response

200

application/json

Current authorized summary state

id · string<uuid> · required

state · enum<string> · required

Available options: queued, running, succeeded, failed, cancelled, expired, superseded

review_state · enum<string> · required

Available options: unreviewed, approved, rejected, stale

revision · integer · required

Required range: x >= 1

candidate_revision · integer · required

Required range: x >= 0

summary_revision · integer · required

Current approved-pointer revision to supply as expected_approved_revision when reviewing; advances on withdrawal too.

Required range: x >= 0

source_revision · integer

Required range: x >= 1

outcomes · object[]

Maximum array length: 5

Show child attributes

selection · object[]

Maximum array length: 5

Show child attributes

facts · object[]

Maximum array length: 512

Show child attributes

coverage · object[]

Maximum array length: 256

Show child attributes

parameters · object[]

Maximum array length: 64

Show child attributes

error_code · enum<string>

Available options: quota_exceeded, provider_unavailable, unsupported_source, stale_source, invalid_output, cancelled, timed_out, permission_denied