---
title: "One held action"
method: GET
path: "/approvals/{id}"
---

# One held action

`GET /approvals/{id}`

## Request

- Base URL: `https://secureai.one/v1`
- URL: `https://secureai.one/v1/approvals/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

The approval.

- object
  - `approval` Approval: An action held for a person. Carries the kinds and locations of what was found and never the values — a reviewer needs the shape, not the digits.
    - `id` string, required
    - `createdAt` integer, required
    - `expiresAt` integer, required
    - `status` 'pending' | 'approved' | 'denied' | 'expired', required
    - `agent` string, nullable
    - `tool` string, required
    - `keyId` string, required
    - `findings` Finding[], required
      - `kind` 'secret' | 'card' | 'iban' | 'ssn' | 'govid' | 'email' | 'phone' | 'address' | 'postcode' | 'name' | 'host', required
      - `path` string, required: Dotted path into the action, e.g. "body.customer.email". Empty when the input was a bare string.
      - `decision` 'allow' | 'redact' | 'approve' | 'block', required
    - `decidedBy` string
    - `decidedAt` integer
    - `note` string

## Other responses

- `404`: No such approval.

---

[API](https://skmtc.dev/secureai/apis/secure-ai.md) · [All operations](https://skmtc.dev/secureai/apis/secure-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/secureai/apis/secure-ai/revisions/6eefd7f53f8b?raw)