# AmpleRun Admin API

**Canonical:** https://apis.io/apis/amplerun-com/amplerun-com-admin-api/  
**Provider:** AmpleRun — https://apis.io/providers/amplerun-com/  
**Base URL:** https://amplerun-api.spiry.org  
**Documentation:** https://docs.amplerun.com/reference/api/

AmpleRun Admin API is one of 10 APIs that [AmpleRun](https://apis.io/providers/amplerun-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Admin. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Operator console. Admin session with TOTP only; API keys are rejected.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/admin/users` | Admin user view (Admin); immutable references |
| GET | `/api/v1/admin/users/{id}` | User detail (Admin) — role, capabilities, MFA, linked providers, wallets… |
| POST | `/api/v1/admin/users/{id}/actions` | User management command (Admin+step-up); typed reason, expected version, audit… |
| GET | `/api/v1/admin/machines` | Admin machine view (Admin) |
| GET | `/api/v1/admin/jobs` | Admin job view (Admin) |
| GET | `/api/v1/admin/ledger` | Admin ledger view (Admin) |
| GET | `/api/v1/admin/payouts` | Admin payout and withdrawal view (Admin); rows carry kind, and unsigned… |
| GET | `/api/v1/admin/tickets` | Admin ticket view (Admin) |
| GET | `/api/v1/admin/audit` | Admin audit view (Admin) |
| GET | `/api/v1/admin/reconciliation` | Admin reconciliation view (Admin); unexplained differences >0 micro pause new… |
| GET | `/api/v1/admin/analytics` | Admin analytics (Admin); committed capacity, paid time, GMV, fees, costs… |
| GET | `/api/v1/admin/status` | Admin status bar (Admin); admissions, reconciliation, worker heartbeat age and… |
| GET | `/api/v1/admin/search` | Resolve a record id (Admin) |
| GET | `/api/v1/admin/treasury` | Treasury vs liabilities (Admin) |
| GET | `/api/v1/admin/incidents` | Admin incident view (Admin); dispatched alerts with their transport… |
| GET | `/api/v1/admin/machines/{id}/evidence` | Qualification evidence and manifest drift for a machine (Admin) |
| POST | `/api/v1/admin/templates/{templateId}/publish` | Publish template (Admin); audit event; refused unless a qualification record… |
| POST | `/api/v1/admin/machines/{id}/approve` | Approve machine (Admin); reason + expected version; in-flight work gets… |
| POST | `/api/v1/admin/machines/{id}/quarantine` | Quarantine machine (Admin); reason + expected version; in-flight work gets… |
| POST | `/api/v1/admin/refunds` | Refund (Admin+recentMFA); evidence/reason, exact immutable manifest or… |
| POST | `/api/v1/admin/payouts/{id}/approve` | Approve payout manifest (Admin+recentMFA); exact immutable manifest hash… |
| POST | `/api/v1/admin/payouts/{id}/signed-transaction` | Submit signer-produced raw transaction (Admin+recentMFA); verified to match… |
| POST | `/api/v1/admin/payouts/{id}/review` | Approve or reject a host payout held by the automatic payout path (Admin + TOTP… |
| POST | `/api/v1/admin/withdrawals/{id}/review` | Approve or reject a renter withdrawal held by the automatic payout path (Admin… |
| POST | `/api/v1/admin/admissions` | Pause/resume admissions (Admin+recentMFA); pauses new jobs/credits as… |
| GET | `/api/v1/admin/settings` | List settings (Admin); the D-20 registry grouped by category, plus every… |
| PATCH | `/api/v1/admin/settings/{key}` | Update one setting (Admin+recentMFA); typed reason + expected-version CAS; a… |
| POST | `/api/v1/admin/settings/test` | Test one subsystem's connectivity (Admin, rate limited)… |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/amplerun-com/openapi/amplerun-com-admin-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/amplerun-com/json-schema/amplerun-com-offer-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/amplerun-com/json-schema/amplerun-com-deposit-address-schema.json
- **JSONSchema** — https://artifacts.apis.io/amplerun-com/json-schema/amplerun-com-template-schema.json
- **JSONSchema** — https://artifacts.apis.io/amplerun-com/json-schema/amplerun-com-job-schema.json
- **JSONSchema** — https://artifacts.apis.io/amplerun-com/json-schema/amplerun-com-quote-schema.json
- **JSONSchema** — https://artifacts.apis.io/amplerun-com/json-schema/amplerun-com-telemetry-sample-schema.json

## Other AmpleRun APIs (9)

- [AmpleRun Account API](https://apis.io/apis/amplerun-com/amplerun-com-account-api/)
- [AmpleRun Agents API](https://apis.io/apis/amplerun-com/amplerun-com-agents-api/)
- [AmpleRun Billing API](https://apis.io/apis/amplerun-com/amplerun-com-billing-api/)
- [AmpleRun Catalog API](https://apis.io/apis/amplerun-com/amplerun-com-catalog-api/)
- [AmpleRun Health API](https://apis.io/apis/amplerun-com/amplerun-com-health-api/)
- [AmpleRun Hosts API](https://apis.io/apis/amplerun-com/amplerun-com-hosts-api/)
- [AmpleRun Jobs API](https://apis.io/apis/amplerun-com/amplerun-com-jobs-api/)
- [AmpleRun Support API](https://apis.io/apis/amplerun-com/amplerun-com-support-api/)
- [AmpleRun Wallets API](https://apis.io/apis/amplerun-com/amplerun-com-wallets-api/)

## Tags

Admin

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/amplerun-com/amplerun-com-admin-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/amplerun-com/.