---
title: "Get Active Agent Control Profile"
method: GET
path: "/v1/agent-control-profiles/active"
tags: ["enterprise-agent-control"]
---

# Get Active Agent Control Profile

`GET /v1/agent-control-profiles/active`

## Request

- Base URL: `https://api.forgeorbital.com`
- URL: `https://api.forgeorbital.com/v1/agent-control-profiles/active`
- Auth: one of:
  - API key in header `X-API-Key`
  - OAuth 2 (client credentials, token URL `/oauth/token`, scopes: `decision_records`)
  - HTTP bearer

Read one authenticated tenant profile lineage's active version.

## Query parameters

- `profile_id` string, required: Exact tenant profile lineage whose active immutable version must be returned.

## Response `200`

Successful Response

- AgentControlProfileResponse
  - `schema_version` 'forge-agent-control-profile/v1' | 'forge-agent-control-profile/v2', required
  - `tenant_id` string, required
  - `profile_id` string, required
  - `version` integer, required
  - `decision_options` string[], required
  - `abstention_action` string, required
  - `hard_constraints` string[], required
  - `required_approvals` string[], required
  - `permitted_attester_key_ids` string[], nullable
  - `control_attester_grants` ControlAttesterGrant[], nullable
    - `key_id` string, required
    - `kind` 'constraint' | 'approval', required
    - `labels` string[], required
  - `control_attestation_context` ControlAttestationContext: Server-owned replay boundary a customer signer must bind exactly.
    - `audience` 'forge-enterprise-decision-control', required
    - `environment` string, required
    - `deployment_id` string, required
  - `permitted_outcome_authority_ids` string[], required
  - `profile_sha256` string, required
  - `prior_active_profile_sha256` string, nullable
  - `created_by_principal_sha256` string, required
  - `created_at` string, required
  - `active` true, required
  - `idempotent_replay` boolean, required

## Other responses

- `422`: Stable, sanitized product API error.
- `default`: Stable, sanitized product API error.

---

[API](https://skmtc.dev/forgeorbital/apis/forge-decision-records-api.md) · [All operations](https://skmtc.dev/forgeorbital/apis/forge-decision-records-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forgeorbital/apis/forge-decision-records-api/revisions/4410e0e5c86a?raw)