> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Approve similar actions

> Approve a class of held goal actions at once, with a use cap and an expiry.

A goal with [`approvals`](https://docs.oneshotagent.com/api-reference/compute/create#param-approvals) holds each matching call until you approve it. One approval covers one exact call. When a goal makes the same call to many people, approve the class: in **Needs you**, a held action shows **Approve all similar (n)**.

That makes a template on the goal and approves the `n` held actions it covers now. Later calls it covers run without asking until its uses or time run out. Only an organization admin can make one; the agent cannot.

## What a template covers

The same tool on the same goal, with every detail equal except the recipient:

| Tool | May differ | Must match |
| - | - | - |
| `email` | `to`, `cc`, `bcc` | Subject, body, every other field |
| `sms` | `to` | The message |
| `voice` | `to` | The objective (the script), caller name, every other field |
| `commerce_buy` | `quantity`, up to the template's | Product, variant, shipping address |
| Any other tool | Nothing | Every field |

The quoted amount may not exceed the held action's. The [suppression list](https://docs.oneshotagent.com/sdk/suppressions.md), quiet hours and daily caps apply first, and a call you denied stays denied.

Each covered call takes one use; the ones approved at creation count. Two calls racing for the last use: one runs, the other waits for you. A revoked template approves nothing more; what it approved stays approved.

## Reminders and expiry

A held action or a question to you has no deadline by default. **Edit** on the goal page sets:

* **Remind me after (hours):** one reminder per unanswered request. Default 24, 0 for none.
* **Expire after (hours):** then a held action is denied and a question closed, and the agent carries on without the answer. Default never. Setting or shortening it needs an admin.

A paused goal gets no reminders and nothing expires.

## API

Admins only, except the list. Each change is an audit entry under Policies.

| Route | Does |
| - | - |
| `POST /v1/org/waiting/:id/approve-similar` `{ max_uses?, expires_in_hours? }` | Makes the template and approves the matches. Defaults 100 uses (1 to 100,000) and 168 hours (1 to 2,160); `null` for none |
| `GET /v1/org/goals/:goalId/approval-templates` | The goal's templates, newest first, with `uses` and `state` |
| `POST /v1/org/goals/:goalId/approval-templates/:id/revoke` | Revokes one |
| `POST /v1/org/goals/:goalId/edit` `{ owner_waits: { remind_after_hours, expire_after_hours } }` | Sets reminders and expiry |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.