---
title: "New Agent Approval"
method: POST
path: "/api/v1/agent-approval"
---

# New Agent Approval

`POST /api/v1/agent-approval`

## Request

- Base URL: `https://authyouragent.com` (the document declares no server; this is the origin it was published from)
- URL: `https://authyouragent.com/api/v1/agent-approval`
- Auth: none declared

Agent-initiated approval request. Does NOT require a site grant.
Used by agents using Take over (sites that have not adopted Auth Your Agent)
to get the owner's approval before performing a sensitive action.
The owner's approval mode (cloud/modes.py, rules only) may approve it
without asking; that is recorded in Activity with the reason.

## Request body

- StepupIn
  - `agent_id` string, required
  - `site` string, required
  - `action` string, required
  - `agent_jwt` string, required
  - `stepup_request` string, nullable
  - `details` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/authyouragent/apis/auth-your-agent-cloud-slice.md) · [All operations](https://skmtc.dev/authyouragent/apis/auth-your-agent-cloud-slice/llms.txt) · [OpenAPI document](https://skmtc.dev/authyouragent/apis/auth-your-agent-cloud-slice/revisions/196372971a43?raw)