# AIMEAT Federation API

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

Node peering and cross-node routing

## Operations (60 of 79)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/federation/peer/request` | Request peering |
| GET | `/v1/federation/peer/request/{id}/status` | Check peering request status |
| POST | `/v1/federation/test` | Run readiness test on candidate node |
| GET | `/v1/admin/peering/requests` | List pending peering requests |
| DELETE | `/v1/admin/peering/requests/{id}` | Delete a peering request |
| PUT | `/v1/admin/peering/requests/{id}` | Approve/reject peering request |
| POST | `/v1/admin/peering/requests/{id}/decision` | Approve/reject peering request (notice buttons) |
| POST | `/v1/federation/peer/activate` | Activate approved peering |
| POST | `/v1/federation/heartbeat` | Peer health heartbeat |
| GET | `/v1/admin/federation/overview` | The Federation page in one read (admin) |
| GET | `/v1/federation/peers` | List peers |
| POST | `/v1/federation/peers` | Add peer manually |
| PUT | `/v1/federation/peers/{nodeId}` | Update peer config |
| DELETE | `/v1/federation/peers/{nodeId}` | De-peer |
| PUT | `/v1/federation/peers/{nodeId}/relay-claim` | Keep one peer on its own relay-claim setting (operator) |
| POST | `/v1/federation/peers/{nodeId}/promote` | Promote a visiting peer to full member (operator vouch) |
| GET | `/v1/federation/network-policy` | The active federation network policy (signed) |
| PUT | `/v1/federation/network-policy` | Author the federation network policy (genesis/operator) |
| POST | `/v1/federation/network-policy/pull` | Pull + apply the network policy from this node's genesis |
| GET | `/v1/federation/node-card` | This node's federation card |
| GET | `/v1/federation/book` | The federation book (operators + resources per node) |
| POST | `/v1/federation/book/rebuild` | Reassemble the federation book (primary, operator) |
| POST | `/v1/federation/book/pull` | Pull + mirror the federation book from this node's genesis (operator) |
| GET | `/v1/federation/service-summary` | Service summary for network directory |
| POST | `/v1/federation/auth/verify` | Verify credentials for federated login |
| POST | `/v1/federation/ping` | Federation health check |
| POST | `/v1/federation/replicate` | Receive replicated memory |
| POST | `/v1/federation/retract` | Take back a replicated memory entry |
| POST | `/v1/federation/catalogue-sync` | Receive catalogue updates from peer |
| POST | `/v1/federation/key-exchange` | Exchange public keys with peer |
| POST | `/v1/federation/trust-advisory` | Issue or receive a trust advisory |
| POST | `/v1/federation/presence` | Receive a peer node's presence push (snapshot or delta) |
| POST | `/v1/federation/peer/introduce` | Introduce a new peer |
| POST | `/v1/federation/link-invites` | Mint a one-time link invitation |
| GET | `/v1/federation/link-invites` | List link invitations |
| DELETE | `/v1/federation/link-invites/{id}` | Revoke a link invitation |
| GET | `/v1/federation/peer/introduce/{id}/status` | Check introduction status |
| POST | `/v1/federation/route` | Route request to remote node |
| GET | `/v1/federation/resolve/{gaii}` | Resolve GAII to node |
| POST | `/v1/federation/cross-node/work` | Cross-node work request |
| POST | `/v1/federation/settle` | Receive settlement from peer |
| POST | `/v1/federation/settle/outbound` | Initiate outbound settlement |
| GET | `/v1/federation/genesis-peer/{id}/subscriptions` | Get genesis peer subscriptions |
| PUT | `/v1/federation/genesis-peer/{id}/subscriptions` | Update genesis peer subscriptions |
| PUT | `/v1/federation/genesis-peer/{id}/suspend` | Suspend genesis peer |
| POST | `/v1/federation/genesis-catalogue-ingest` | Ingest genesis catalogue data |
| POST | `/v1/federation/genesis-memory-read` | Read memory from genesis peer (authenticated) |
| GET | `/v1/federation/genesis-memory-read` | Read memory for an approved genesis peer |
| GET | `/v1/federation/package-sales/{groupId}/config-needs` | A seller node reads a package's questions, signed |
| PUT | `/v1/federation/package-sales/{groupId}/entitlements/{nodeId}` | A seller node grants a customer node, signed |
| DELETE | `/v1/federation/package-sales/{groupId}/entitlements/{nodeId}` | A seller node revokes a customer node, signed |
| GET | `/v1/federation/package-sales/{groupId}/offer` | A seller node reads a package's terms, signed |
| PUT | `/v1/federation/package-sales/{groupId}/claims` | A seller node makes a claim code, signed |
| POST | `/v1/federation/package-claims/{groupId}` | A node redeems a claim code, signed with its own key |
| GET | `/v1/federation/packages` | What this repository serves the calling node |
| GET | `/v1/federation/peers/{nodeId}/packages` | What a repository peer serves this node |
| POST | `/v1/federation/packages/pull` | Bring a package in from another node |
| GET | `/v1/federation/packages/{groupId}/attestation` | This node's signed statement about a package |
| GET | `/v1/federation/templates` | List federation templates |
| POST | `/v1/federation/templates/sync` | Sync templates from federation |

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

## Machine-readable artifacts (7)

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

Federation

---

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