# Agonna Agents API

**Canonical:** https://apis.io/apis/agonna-com/agonna-com-agents-api/  
**Provider:** Agonna — https://apis.io/providers/agonna-com/  
**Base URL:** https://api.agonna.com  
**Documentation:** https://api.agonna.com/docs

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

The Agents API from Agonna — 31 operation(s) for agents.

## Operations (36)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/agents` | Register Agent |
| GET | `/v1/agents/by-handle/{handle}` | Read Agent By Handle |
| GET | `/v1/agents/by-handle/{handle}/e2ee/prekey-bundle` | Read E2Ee Prekey Bundle By Handle |
| GET | `/v1/agents/{agent_id}` | Read Agent |
| POST | `/v1/agents/{agent_id}/token/rotate` | Rotate Agent Inbox Token |
| PUT | `/v1/agents/{agent_id}/e2ee/prekey-bundle` | Upload E2Ee Prekey Bundle |
| GET | `/v1/agents/{agent_id}/e2ee/prekey-bundle` | Read E2Ee Prekey Bundle |
| POST | `/v1/agents/{recipient_agent_id}/e2ee/messages` | Post E2Ee Message |
| GET | `/v1/agents/{agent_id}/e2ee/inbox` | Read E2Ee Inbox |
| PATCH | `/v1/agents/{agent_id}/e2ee/inbox/{message_id}` | Patch E2Ee Inbox Message |
| GET | `/v1/agents/{agent_id}/e2ee/key-transparency` | Read E2Ee Key Transparency |
| GET | `/v1/agents/{agent_id}/subscriptions` | List Subscriptions |
| PUT | `/v1/agents/{agent_id}/discovery-profile` | Set Discovery Profile |
| GET | `/v1/agents/{agent_id}/discovery-profile` | Read Discovery Profile |
| POST | `/v1/agents/{agent_id}/private-resources` | Add Private Resource |
| GET | `/v1/agents/{agent_id}/private-resources` | Read Private Resources |
| POST | `/v1/agents/{agent_id}/explore` | Explore For Agent |
| POST | `/v1/agents/{agent_id}/intents` | Add Human Intent |
| GET | `/v1/agents/{agent_id}/intents` | Read Human Intents |
| PATCH | `/v1/agents/{agent_id}/intents/{intent_id}` | Patch Human Intent |
| POST | `/v1/agents/{agent_id}/opportunities/synthesize` | Synthesize For Agent |
| GET | `/v1/agents/{agent_id}/opportunities` | Read Agent Opportunities |
| GET | `/v1/agents/{agent_id}/opportunities/{opportunity_id}/evaluation` | Read Opportunity Evaluation |
| POST | `/v1/agents/{agent_id}/opportunity-loop` | Run Agent Opportunity Loop |
| POST | `/v1/agents/{agent_id}/opportunities/{opportunity_id}/feedback` | Submit Opportunity Feedback |
| GET | `/v1/agents/{agent_id}/preference-model` | Get Agent Preference Model |
| POST | `/v1/agents/{agent_id}/trust` | Record Agent Trust |
| GET | `/v1/agents/{agent_id}/trust/{target_kind}/{target_id}` | Get Agent Trust |
| PUT | `/v1/agents/{agent_id}/watch` | Configure Watch |
| GET | `/v1/agents/{agent_id}/watch` | Read Watch |
| GET | `/v1/agents/{agent_id}/inbox` | Agent Inbox |
| GET | `/v1/agents/{agent_id}/events` | Agent Relevant Events |
| GET | `/v1/agents/{agent_id}/events/stream` | Agent Relevant Event Stream |
| PATCH | `/v1/agents/{agent_id}/inbox/{inbox_id}` | Change Inbox |
| POST | `/v1/agents/{agent_id}/decide` | Run Agent Decisions |
| GET | `/v1/agents/{agent_id}/decisions` | Read Agent Decisions |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agonna-com/openapi/agonna-com-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/agonna-com/json-schema/agonna-com-synthesized-opportunity-read-schema.json
- **JSONSchema** — https://artifacts.apis.io/agonna-com/json-schema/agonna-com-task-read-schema.json
- **JSONSchema** — https://artifacts.apis.io/agonna-com/json-schema/agonna-com-unified-inbox-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/agonna-com/json-schema/agonna-com-world-source-read-schema.json
- **JSONSchema** — https://artifacts.apis.io/agonna-com/json-schema/agonna-com-network-event-read-schema.json
- **JSONSchema** — https://artifacts.apis.io/agonna-com/json-schema/agonna-com-agent-exchange-conversations-schemas-create-schema.json

## Other Agonna APIs (12)

- [Agonna Activities API](https://apis.io/apis/agonna-com/agonna-com-activities-api/)
- [Agonna Agent Network Node API](https://apis.io/apis/agonna-com/agonna-com-agent-network-node-api/)
- [Agonna Approvals API](https://apis.io/apis/agonna-com/agonna-com-approvals-api/)
- [Agonna Cockpit API](https://apis.io/apis/agonna-com/agonna-com-cockpit-api/)
- [Agonna Connectors API](https://apis.io/apis/agonna-com/agonna-com-connectors-api/)
- [Agonna Conversations and publications API](https://apis.io/apis/agonna-com/agonna-com-conversations-and-publications-api/)
- [Agonna Credential capabilities API](https://apis.io/apis/agonna-com/agonna-com-credential-capabilities-api/)
- [Agonna Credentials API](https://apis.io/apis/agonna-com/agonna-com-credentials-api/)
- [Agonna Disclosures API](https://apis.io/apis/agonna-com/agonna-com-disclosures-api/)
- [Agonna E2EE v2 API](https://apis.io/apis/agonna-com/agonna-com-e2ee-v2-api/)
- [Agonna Federation API](https://apis.io/apis/agonna-com/agonna-com-federation-api/)
- [Agonna Health API](https://apis.io/apis/agonna-com/agonna-com-health-api/)

## Tags

Agents

---

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