# Innernet Agents API

**Canonical:** https://apis.io/apis/innernet-live/innernet-live-agents-api/  
**Provider:** Innernet — https://apis.io/providers/innernet-live/  
**Base URL:** https://innernet.live/api  
**Documentation:** https://innernet.live/docs/api

Innernet Agents API is one of 12 APIs that [Innernet](https://apis.io/providers/innernet-live/) 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 Innernet — 16 operation(s) for agents.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/agents` | Make an agent |
| GET | `/v1/agents` | your agents, with what each keeps (an agent key sees only its own) |
| PATCH | `/v1/agents/{agent}` | Change an agent |
| GET | `/v1/agents/{agent}` | one agent, its settings and its counts ({agent} is a slug, an id, or me) |
| DELETE | `/v1/agents/{agent}` | remove an agent with its memory, keys, hook and ledger (not while it has… |
| GET | `/v1/agents/{agent}/memories/{id}` | one memory of the agent |
| PATCH | `/v1/agents/{agent}/memories/{id}` | change a memory: new words make a new version, a fixed one refuses |
| DELETE | `/v1/agents/{agent}/memories/{id}` | forget one memory, with the versions it replaced |
| GET | `/v1/agents/{agent}/memories/{id}/history` | every version of a memory, newest first |
| POST | `/v1/agents/{agent}/forget` | forget by ids or by a filter, with dry_run to see first |
| DELETE | `/v1/agents/{agent}/users/{userId}` | forget one of the agent's users entirely, with a count |
| GET | `/v1/agents/{agent}/export` | the agent and every memory it holds, as json |
| GET | `/v1/agents/{agent}/projects` | the projects tied to an agent: where each lives, its folder, whether knowledge… |
| POST | `/v1/agents/{agent}/projects` | tie one of your projects to an agent, or make one that lives with it |
| PATCH | `/v1/agents/{agent}/projects/{project}` | let its knowledge flow in or not, make it the folder, or move it between you… |
| DELETE | `/v1/agents/{agent}/projects/{project}` | untie a project from an agent; it stays where it is, and lives with you |
| POST | `/v1/agents/{agent}/take-in` | take an agent's own knowledge into a project of yours, before it goes |
| POST | `/v1/agents/{agent}/memories` | Remember |
| GET | `/v1/agents/{agent}/memories` | List memories |
| GET | `/v1/agents/{agent}/events` | The ledger |
| POST | `/v1/agents/{agent}/recall` | Recall |
| GET | `/v1/agents/{agent}/keys` | An agent's keys |
| POST | `/v1/agents/{agent}/keys` | Make a key for an agent |
| DELETE | `/v1/agents/{agent}/keys/{id}` | Revoke an agent's key |
| POST | `/v1/agents/{agent}/context` | Context for a prompt |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/innernet-live/openapi/innernet-live-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/innernet-live/json-schema/innernet-live-agent-policy-schema.json
- **JSONSchema** — https://artifacts.apis.io/innernet-live/json-schema/innernet-live-agent-schema.json
- **JSONSchema** — https://artifacts.apis.io/innernet-live/json-schema/innernet-live-agent-memory-schema.json
- **JSONSchema** — https://artifacts.apis.io/innernet-live/json-schema/innernet-live-room-schema.json
- **JSONSchema** — https://artifacts.apis.io/innernet-live/json-schema/innernet-live-memory-schema.json
- **JSONSchema** — https://artifacts.apis.io/innernet-live/json-schema/innernet-live-agent-key-schema.json
- **APIsJSON** — https://artifacts.apis.io/innernet-live/apis.yml

## Other Innernet APIs (11)

- [Innernet Artifacts API](https://apis.io/apis/innernet-live/innernet-live-artifacts-api/)
- [Innernet Commons API](https://apis.io/apis/innernet-live/innernet-live-commons-api/)
- [Innernet Context API](https://apis.io/apis/innernet-live/innernet-live-context-api/)
- [Innernet Memories API](https://apis.io/apis/innernet-live/innernet-live-memories-api/)
- [Innernet personal memory API](https://apis.io/apis/innernet-live/innernet-live-personal-memory-api/)
- [Innernet Rooms API](https://apis.io/apis/innernet-live/innernet-live-rooms-api/)
- [Innernet Search API](https://apis.io/apis/innernet-live/innernet-live-search-api/)
- [Innernet Self API](https://apis.io/apis/innernet-live/innernet-live-self-api/)
- [Innernet Session API](https://apis.io/apis/innernet-live/innernet-live-session-api/)
- [Innernet Tasks API](https://apis.io/apis/innernet-live/innernet-live-tasks-api/)
- [Innernet Versioning API](https://apis.io/apis/innernet-live/innernet-live-versioning-api/)

## Tags

Agents

---

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