# AIMEAT Identity API

**Canonical:** https://apis.io/apis/aimeat-io/aimeat-io-identity-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 Identity 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 Identity. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Owner and agent registration

## Operations (60 of 88)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/owners` | Register owner |
| GET | `/v1/owners/{name}/export` | Data protection export |
| GET | `/v1/owners/{name}` | Get owner details |
| DELETE | `/v1/owners/{name}` | Data protection delete |
| GET | `/v1/agents/v2/basic-agents` | What the basic agents are, and whether a connector is there to run them |
| POST | `/v1/agents/v2/basic-agents` | Create the basic agents and hand them to the connector already running |
| POST | `/v1/agents/v2/basic-agents/request` | An agent asks its owner to set up the basic agents |
| POST | `/v1/agents/v2/agent-proposals` | Propose a new agent for this account. Creates nothing |
| GET | `/v1/agents/v2/agent-proposals` | What has been proposed on this account, and what was decided |
| POST | `/v1/agents/v2/agent-proposals/{id}/approve` | The owner approves a proposal. |
| GET | `/v1/agents/v2/connectors` | The owner's connectors, as named machines |
| PATCH | `/v1/agents/v2/connectors/{id}` | The owner's name for one connector |
| DELETE | `/v1/agents/v2/connectors/{id}` | Forget a connector that is not connected |
| PUT | `/v1/agents/v2/connectors/{id}/programs/{hash}` | Allow or stop the programs a connector holds under one hash |
| PUT | `/v1/agents/{name}/programs` | A connector reports the programs it may start for one agent |
| POST | `/v1/agents/v2/agents/{name}/attach` | Give an existing agent its credentials on the connector that is running now |
| POST | `/v1/agents/v2/agents/{name}/move` | Send one of the owner's agents to another of their connectors |
| POST | `/v1/agents/v2/agent-proposals/{id}/decline` | The owner declines a proposal |
| POST | `/v1/agents/v2/enrol` | A connected daemon turns an enrolment grant plus signed cards into credentials |
| GET | `/v1/agents/v2/migrate` | Which existing agents would move to a key and a card |
| POST | `/v1/agents/v2/migrate` | Move existing v1 agents onto their own key and card |
| POST | `/v1/agents/v2/token` | Exchange an agent key for a short-lived credential |
| POST | `/v1/agents/v2/messages` | Send one turn to another principal on this account |
| GET | `/v1/agents/v2/messages` | Read turns back, oldest first |
| GET | `/v1/agents/v2/messages/{messageId}` | One turn |
| PUT | `/v1/agents/v2/push-config` | Register where to reach a principal that is not connected |
| GET | `/v1/agents/v2/push-config` | What delivery targets are registered |
| DELETE | `/v1/agents/v2/push-config/{id}` | Stop delivering to one target |
| POST | `/v1/agents/v2/tasks` | Ask a principal on this account to do something |
| GET | `/v1/agents/v2/tasks` | The task roster, newest first |
| GET | `/v1/agents/v2/tasks/{taskId}` | One task |
| POST | `/v1/agents/v2/tasks/{taskId}/status` | The assignee reports where it has got to |
| POST | `/v1/agents/v2/tasks/{taskId}/cancel` | The caller changes its mind |
| POST | `/v1/agui/{owner}/{agent}` | Ask an agent for something and watch it work, as AG-UI events |
| GET | `/v1/agui/{owner}/{agent}/{taskId}` | Watch work that already exists, as AG-UI events |
| GET | `/v1/oasf/{owner}/{agent}` | One agent, as an OASF record |
| GET | `/v1/a2a/{owner}/{agent}/agent-card.json` | One agent, as an A2A AgentCard |
| POST | `/v1/a2a/{owner}/{agent}` | The A2A JSON-RPC surface for one agent |
| GET | `/v1/agents/{gaii}/card` | An agent's public card, signed by this node |
| POST | `/v1/agents/{gaii}/card` | An agent re-issues its own signed card |
| GET | `/v1/agents/{gaii}/card/extended` | The agent's own signed card, in full |
| GET | `/v1/agents/{gaii}/jwks.json` | The key that verifies an agent's card |
| GET | `/v1/agents/{gaii}/card/info` | An agent's card as JSON, for a surface that will not verify it |
| PATCH | `/v1/agents/{name}/description` | What this agent is, in a sentence |
| PATCH | `/v1/agents/{name}/task-start` | Whether this agent's tasks start on their own |
| PATCH | `/v1/agents/{name}/task-start-floor` | Let this agent start work although it holds a permission that can spend, send… |
| POST | `/v1/agents/{name}/stop` | Stop an agent |
| POST | `/v1/agents/{name}/start` | Start a stopped agent |
| GET | `/v1/agents/{gaii}/avatar.svg` | The agent's picture (public) |
| PUT | `/v1/agents/{name}/avatar` | Set an agent's picture |
| DELETE | `/v1/agents/{name}/avatar` | Remove an agent's picture |
| PATCH | `/v1/agents/{name}/clearance` | The highest classification an agent may read |
| PATCH | `/v1/agents/{name}/run-mode` | How this agent is meant to be run |
| PATCH | `/v1/agents/{name}/runtime-source` | What code runs this agent |
| POST | `/v1/agents/device-authorize` | Start device authorization flow |
| POST | `/v1/agents/device-token` | Poll for device authorization result |
| GET | `/v1/agents/verify/info/{userCode}` | Get device auth request details |
| POST | `/v1/agents/verify` | Approve or deny device authorization |
| GET | `/v1/agents` | List own agents |
| POST | `/v1/agents` | Register agent |

…and 28 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/aimeat-io/openapi/aimeat-io-identity-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

Identity

---

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