# AIMEAT Agents API

**Canonical:** https://apis.io/apis/aimeat-io/aimeat-io-agents-api/  
**Provider:** AIMEAT — https://apis.io/providers/aimeat-io/  
**Base URL:** https://aimeat-finland-001-genesis.overscalesolutions.com  
**Documentation:** https://aimeat.io/v1/spec

AIMEAT Agents API is one of 100 APIs that [AIMEAT](https://apis.io/providers/aimeat-io/) 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 Agents. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Agent lifecycle — registration, device authorization, profile, mode, verification, and per-agent overview aggregates

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| PUT | `/v1/agents/{name}/workplace` | Name the workspace an agent's finished work is shared with |
| DELETE | `/v1/agents/{name}/workplace` | Keep an agent's finished work in its own memory again |
| GET | `/v1/agents/{name}/ai-keys` | One agent's AI settings. Never a key |
| PUT | `/v1/agents/{name}/ai-keys` | Set an agent's own keys, its daily cap and its gate switch (the owner in person) |
| DELETE | `/v1/agents/{name}/ai-keys/{model}` | Forget one of an agent's keys and the name of its variable (the owner in person) |
| POST | `/v1/agents/{name}/ai-keys/{model}/test` | One tiny real call on the key that would pay for this agent (the owner in… |
| GET | `/v1/ledger/usage` | Agent LLM usage/cost aggregates (LEDGER / TARGET-016) |
| GET | `/v1/ledger/usage/runs` | Agent LLM usage grouped by run (drill to a deliverable) |
| GET | `/v1/ledger/usage/capabilities` | Agent LLM usage grouped by capability (LEDGER / TARGET-018 double-entry) |
| GET | `/v1/ledger/budget` | Owner LLM spend vs daily budget + per-agent breakdown (LEDGER / TARGET-017) |
| GET | `/v1/ledger/billing` | Owner monthly LLM billing rollup, self-host/hosted split (LEDGER / TARGET-019) |
| GET | `/v1/agents/{name}/purchase-limit` | An agent's daily purchase limit in money, and what it spent today |
| PUT | `/v1/agents/{name}/purchase-limit` | Set or remove an agent's daily purchase limit in one currency |
| PUT | `/v1/agents/{name}/capabilities` | Report agent capabilities |
| GET | `/v1/agents/{name}/capabilities` | Get agent capabilities |
| GET | `/v1/agents/{name}/refusals` | Calls the node refused this agent for a missing permission |
| POST | `/v1/agents/{name}/refusals/decline` | The owner will not give the permissions behind the agent's refusals |
| GET | `/v1/agents/{name}/activity` | Get agent activity stats and history |
| GET | `/v1/agents/{name}/activity/log` | Get agent activity event log |
| GET | `/v1/agents/{name}/statistics` | Get agent quality statistics (Quality tab) |
| GET | `/v1/agents/device-authorize/pending` | List pending device-authorization requests |
| DELETE | `/v1/agents/{name}` | Delete an agent |
| PATCH | `/v1/agents/{name}/mode` | Set an agent's operating mode |
| PATCH | `/v1/agents/{name}/console-url` | Set where an agent's host manages it |
| POST | `/v1/admin/agents/{gaii}/remind` | Send an onboarding reminder to an agent |
| POST | `/v1/admin/agents/{gaii}/onboarding/skip` | Skip an agent onboarding step |
| POST | `/v1/admin/skill-bundles/{platform}/notify` | Notify a skill-bundle platform |
| GET | `/v1/ledger/usage/overview` | AI usage grouped by model, with the per-run drill, in one read |
| GET | `/v1/agents/{name}/activity/overview` | The agent's Activity subtab in one read |
| GET | `/v1/agents/{name}/quality/overview` | The agent's Quality subtab in one read |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/aimeat-io/openapi/aimeat-io-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-workflow-def-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-workflow-run-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-schedule-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-ai-provenance-declaration-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-app-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-memory-write-schema.json

## Other AIMEAT APIs (12)

- [AIMEAT A2A API](https://apis.io/apis/aimeat-io/aimeat-io-a2a-api/)
- [AIMEAT Actions API](https://apis.io/apis/aimeat-io/aimeat-io-actions-api/)
- [AIMEAT Admin API](https://apis.io/apis/aimeat-io/aimeat-io-admin-api/)
- [AIMEAT Agent Crew API](https://apis.io/apis/aimeat-io/aimeat-io-agent-crew-api/)
- [AIMEAT Agent Directives API](https://apis.io/apis/aimeat-io/aimeat-io-agent-directives-api/)
- [AIMEAT Agent Goals API](https://apis.io/apis/aimeat-io/aimeat-io-agent-goals-api/)
- [AIMEAT Agent Integration API](https://apis.io/apis/aimeat-io/aimeat-io-agent-integration-api/)
- [AIMEAT Agent Messages API](https://apis.io/apis/aimeat-io/aimeat-io-agent-messages-api/)
- [AIMEAT Agent Onboarding API](https://apis.io/apis/aimeat-io/aimeat-io-agent-onboarding-api/)
- [AIMEAT Agent Tasks API](https://apis.io/apis/aimeat-io/aimeat-io-agent-tasks-api/)
- [AIMEAT Agent Telemetry API](https://apis.io/apis/aimeat-io/aimeat-io-agent-telemetry-api/)
- [AIMEAT Agent Webhooks API](https://apis.io/apis/aimeat-io/aimeat-io-agent-webhooks-api/)

## Tags

Agents

---

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