---
title: "Approval By Token"
method: GET
path: "/v1/approve/{token}"
tags: ["approvals"]
---

# Approval By Token

`GET /v1/approve/{token}`

## Request

- Base URL: `https://api.actuato.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.actuato.com/v1/approve/{token}`
- Auth: none declared

Magic-link landing: the signed-in principal sees what they're being asked to approve.

## Path parameters

- `token` string, required

## Response `200`

Successful Response

- ApprovalOut
  - `id` string, uuid, required
  - `principal_user_id` string, uuid, required
  - `agent_id` string, uuid, required
  - `kind` 'publish_job' | 'hire' | 'fund_escrow' | 'release_payment' | 'increase_budget' | 'cancel_job', required
  - `subject_type` string, required
  - `subject_id` string, uuid, required
  - `payload` object, required
  - `status` 'pending' | 'approved' | 'rejected' | 'expired', required
  - `expires_at` string, date-time, required
  - `decided_at` string, date-time, nullable, required
  - `decided_via` 'web' | 'magic_link' | 'push' | 'mcp_elicitation', required
  - `decision_note` string, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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