---
title: "List human-review approval records"
method: GET
path: "/v1/projects/{project_id}/automation-approvals"
tags: ["Automation"]
---

# List human-review approval records

`GET /v1/projects/{project_id}/automation-approvals`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/projects/{project_id}/automation-approvals`
- Auth: HTTP bearer

Human members inspect pending or decided approvals. Only project owners may decide them.

## Path parameters

- `project_id` string, required

## Query parameters

- `status` 'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled'
- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `approvals` object[], required
    - `data_boundary` object, required
      - `schema_version` '1', required
      - `classification` 'untrusted_observation' | 'untrusted_observation_and_runner_evidence' | 'runner_and_owner_annotation' | 'server_control_with_authority_free_observation' | 'server_owned_bounded_aggregate' | 'external_response', required
      - `content_role` 'evidence_only', required
      - `instruction_authority` 'none', required
      - `trusted_provenance_does_not_mean_trusted_content` true, required
      - `external_url_policy` 'do_not_fetch', required
      - `command_policy` 'do_not_execute', required
      - `authority_source` 'enabled_automation_contract_and_server_policy_only', required
      - `applies_to` union
        - string
        - string[]
      - `inspection` object
        - `heuristic_only` true, required
        - `indicators` string[], required
        - `external_url_hosts` string[], required
        - `redacted_paths` string[], required
        - `truncated_paths` string[], required
      - `control_fields` string[]
      - `identifier_columns_included` boolean
      - `secret_values_included` boolean
    - `id` string, required
    - `project_id` string, required
    - `automation_id` string, required
    - `run_id` string, required
    - `action` 'draft_pr', required
    - `status` 'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled', required
    - `requested_by` string, required
    - `decided_by` string, nullable, required
    - `subject_hash` string, required
    - `evidence` object, required
      - `request_reason` string, nullable, required
      - `decision_reason` string, nullable, required
      - `subject` BoundedEvidenceObject, required
    - `run_url` string, required
    - `requested_at` integer, required
    - `decided_at` integer, nullable, required
    - `expires_at` integer, required
  - `pagination` object, required
    - `kind` 'descending_keyset', required
    - `sort` 'timestamp_desc_id_desc', required
    - `limit` integer, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required
    - `follow_up` object, nullable, required
      - `operation_id` 'list_automation_runs' | 'list_automation_approvals' | 'list_automation_trigger_receipts', required
      - `method` 'GET', required
      - `href` string, required
      - `required_principal` 'human_owner_or_member' | 'human_or_exact_bound_runner', required
  - `next_action` string, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/agentry/apis/agentry-api.md) · [All operations](https://skmtc.dev/agentry/apis/agentry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentry/apis/agentry-api/revisions/abdecddf009f?raw)