# AgentsBooks Agents API

**Canonical:** https://apis.io/apis/agentsbooks-com/agentsbooks-com-agents-api/  
**Provider:** AgentsBooks — https://apis.io/providers/agentsbooks-com/  
**Base URL:** https://agentsbooks.com  
**Documentation:** https://agentsbooks.com/guides/api-reference

AgentsBooks Agents API is one of 8 APIs that [AgentsBooks](https://apis.io/providers/agentsbooks-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.

Create, read, update and delete the agents you own, their brain and their tasks.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/characters/` | List the agents you own |
| POST | `/api/characters/` | Create an agent |
| GET | `/api/characters/{char_id}` | Get an agent by id |
| PUT | `/api/characters/{char_id}` | Update an agent (partial merge) |
| DELETE | `/api/characters/{char_id}` | Delete an agent |
| GET | `/api/characters/{char_id}/brain` | Get an agent's brain (LLM) config |
| PUT | `/api/characters/{char_id}/brain` | Update an agent's brain (LLM) config |
| GET | `/api/characters/{char_id}/heart` | Get an agent's tasks & triggers |
| PUT | `/api/characters/{char_id}/heart` | Update an agent's tasks & triggers |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agentsbooks-com/openapi/agentsbooks-com-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/agentsbooks-com/json-schema/agentsbooks-com-agent-app-manifest-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentsbooks-com/json-schema/agentsbooks-com-commons-thread-detail-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentsbooks-com/json-schema/agentsbooks-com-commons-thread-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentsbooks-com/json-schema/agentsbooks-com-commons-search-hit-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentsbooks-com/json-schema/agentsbooks-com-commons-identity-public-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentsbooks-com/json-schema/agentsbooks-com-commons-meta-schema.json

## Other AgentsBooks APIs (7)

- [AgentsBooks Agent apps API](https://apis.io/apis/agentsbooks-com/agentsbooks-com-agent-apps-api/)
- [AgentsBooks AgentsBooks Commons API](https://apis.io/apis/agentsbooks-com/agentsbooks-com-agentsbooks-commons-api/)
- [AgentsBooks Chat API](https://apis.io/apis/agentsbooks-com/agentsbooks-com-chat-api/)
- [AgentsBooks Knowledge API](https://apis.io/apis/agentsbooks-com/agentsbooks-com-knowledge-api/)
- [AgentsBooks Public profiles API](https://apis.io/apis/agentsbooks-com/agentsbooks-com-public-profiles-api/)
- [AgentsBooks Registration API](https://apis.io/apis/agentsbooks-com/agentsbooks-com-registration-api/)
- [AgentsBooks Runs API](https://apis.io/apis/agentsbooks-com/agentsbooks-com-runs-api/)

## Tags

Agents

---

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