# agentleFS API

**Canonical:** https://apis.io/apis/agentlefs-com/agentlefs-com-api/  
**Provider:** agentleFS — https://apis.io/providers/agentlefs-com/  
**Base URL:** https://mcp.agentlefs.com  
**Documentation:** https://agentlefs.com/docs/api

agentleFS API is published by [agentleFS](https://apis.io/providers/agentlefs-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

agentleFS API as documented publicly: 21 operations. Contract generated from the documentation by API Evangelist (2026-11-01); not the provider's own document.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| POST | `/mcp` | Remote HTTP (Streamable HTTP) — afs_ header POST to /mcp — one endpoint, the whole toolset. |
| GET | `/v1/documents` | list documents in a folder |
| POST | `/v1/documents` | create a document |
| GET | `/v1/documents/handbook/onboarding/day-one.md` | GET /v1/documents/handbook/onboarding/day-one.md |
| PUT | `/v1/documents/handbook/onboarding/day-one.md` | PUT /v1/documents/handbook/onboarding/day-one.md |
| DELETE | `/v1/documents/{location}` | delete a document |
| GET | `/v1/documents/{location}` | read a document |
| PUT | `/v1/documents/{location}` | update a document |
| GET | `/v1/folders` | list folders, one level |
| POST | `/v1/folders` | POST /v1/folders |
| GET | `/v1/folders/export` | download a folder as a zip |
| DELETE | `/v1/grants` | revoke a grant |
| GET | `/v1/grants` | who can reach a scope |
| POST | `/v1/grants` | grant a role on a scope |
| GET | `/v1/health` | liveness, and which build is serving |
| POST | `/v1/moves` | move to another folder |
| GET | `/v1/openapi.yaml` | this API's OpenAPI spec |
| POST | `/v1/renames` | rename in place |
| GET | `/v1/search` | search reachable content |
| POST | `/v1/undeletes` | undo the last delete at a location |
| POST | `/v1/uploads` | upload files by sha256 and size; PUT each to its url |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/agentlefs-com/openapi/_ae-authored/agentlefs-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/agentlefs-com/json-schema/agentlefs-com-post-mcp-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentlefs-com/json-schema/agentlefs-com-post-v1-moves-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentlefs-com/json-schema/agentlefs-com-post-v1-documents-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentlefs-com/json-schema/agentlefs-com-post-v1-renames-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentlefs-com/json-schema/agentlefs-com-get-v1-documents-location-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentlefs-com/json-schema/agentlefs-com-post-v1-grants-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/agentlefs-com/apis.yml

---

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