# John\'s Essentials Agent API

**Canonical:** https://apis.io/apis/johnsessentials-com/johnsessentials-com-agent-api/  
**Provider:** John\'s Essentials — https://apis.io/providers/johnsessentials-com/  
**Base URL:** https://api.johnsessentials.com/api/v1  
**Documentation:** https://johnsessentials.com/docs

John\'s Essentials Agent API is one of 11 APIs that [John\'s Essentials](https://apis.io/providers/johnsessentials-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

AI agent orchestration (tool calls, workflows, streaming)

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/public/agent/conversations` | List saved agent conversations |
| DELETE | `/public/agent/conversations/{id}` | Delete a conversation and its turns |
| GET | `/public/agent/conversations/{id}` | Get a conversation with its turns |
| PATCH | `/public/agent/conversations/{id}` | Rename a conversation |
| GET | `/public/agent/history` | List recent agent runs |
| DELETE | `/public/agent/jobs/{jobId}` | Cancel an in-flight agent run |
| GET | `/public/agent/jobs/{jobId}` | Poll an agent run's status and result |
| GET | `/public/agent/jobs/{jobId}/stream` | Subscribe to live SSE events for an agent run |
| POST | `/public/agent/run` | Run the AI agent orchestrator |
| POST | `/public/agent/run/async` | Run the AI agent asynchronously |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/johnsessentials-com/openapi/johnsessentials-com-agent-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/johnsessentials-com/json-schema/johnsessentials-com-job-event-schema.json
- **APIsJSON** — https://artifacts.apis.io/johnsessentials-com/apis.yml

## Other John\'s Essentials APIs (10)

- [John\'s Essentials Authentication API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-authentication-api/)
- [John\'s Essentials Files API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-files-api/)
- [John\'s Essentials MCP API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-mcp-api/)
- [John\'s Essentials Memory API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-memory-api/)
- [John\'s Essentials OpenAI Compatibility API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-openai-compatibility-api/)
- [John\'s Essentials Organizations API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-organizations-api/)
- [John\'s Essentials Status API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-status-api/)
- [John\'s Essentials Tools API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-tools-api/)
- [John\'s Essentials Webhooks API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-webhooks-api/)
- [John\'s Essentials Workflows API](https://apis.io/apis/johnsessentials-com/johnsessentials-com-workflows-api/)

## Tags

Agents

---

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