canonical: https://jentic.com/apis/pydio.com/pydio

# Pydio Cells API

REST API for Pydio Cells, the open-source file sharing and collaboration platform. Provides 248+ endpoints covering tree/file operations, user management, ACLs, roles, workspaces, sharing, activity streams, configuration, search, jobs/scheduler, authentication, frontend, and meta services. The API exposes 43 endpoints secured with bearer, oauth2 authentication.

## For AI agents

Programmatically get node metadata, create file or folder. Covers 43 operations with bearer, oauth2 authentication.

## Scope

Does not handle payments, communications, or crm - use for productivity only.

## Capabilities

- Get node metadata
- Create file or folder
- Delete files or folders
- Restore deleted files or folders
- Bulk stat nodes
- Admin list nodes

## Use cases

### Productivity Operations

Use the Pydio Cells API to perform productivity operations programmatically. The API provides 43 endpoints covering core functionality including get node metadata, create file or folder, delete files or folders.

Example prompt: Call GET `/a/tree/stat/{Node}` to get node metadata

### Automated A Management

Automate a operations by combining multiple Pydio Cells API endpoints. Agents can create file or folder and then delete files or folders in a single workflow.

Example prompt: Call POST `/a/tree/create` to create file or folder, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Pydio Cells API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle bearer, oauth2 tokens manually.

Example prompt: Search Jentic for 'get node metadata', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/a/tree/stat/{Node}` | Get node metadata |
| POST | `/a/tree/create` | Create file or folder |
| POST | `/a/tree/delete` | Delete files or folders |
| POST | `/a/tree/restore` | Restore deleted files or folders |
| POST | `/a/tree/selection` | Create a temporary selection of nodes |
| POST | `/a/tree/stats` | Bulk stat nodes |
| POST | `/a/tree/admin/list` | Admin list nodes |
| GET | `/a/user/{Login}` | Get user by login |

## Key resources

- **A** — Operations for a

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 63 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 74 / 100
  - Developer Experience & Jentic Compatibility: 61 / 100
  - AI-Readiness & Agent Experience: 49 / 100
  - Agent Usability: 94 / 100
  - Security: 75 / 100
  - AI Discoverability: 46 / 100
- **View full report:** https://jentic.com/apis/pydio.com/pydio/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Pydio Cells API by hand means setting up its bearer or OAuth2 auth, pointing at your own Cells host, and handling tree and user calls yourself. Through Jentic you install once, import the Pydio Cells API from the API Directory, store the credential once, and your agent calls it.
- **Permission scoping:** Pydio Cells drives create, delete, and restore from a request body while node and user reads carry the target in the path, so scope the agent to the operations it needs, such as reading node metadata or listing stats. You choose that allowed set, so deleting nodes is not included unless you add it.
- **Credential handling:** Your Pydio Cells credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'read node metadata' or 'list files in a folder', and Jentic returns the matching Pydio Cells operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Asana** — Alternative productivity API
- **Monday** — Alternative productivity API
- **Clickup** — Complementary productivity API

## FAQ

### What authentication does the Pydio Cells API use?

The Pydio Cells API uses bearer, oauth2 authentication. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I get node metadata with the Pydio Cells API?

Yes. Use the GET `/a/tree/stat/{Node}` endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Pydio Cells API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I get node metadata through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'get node metadata'. Jentic returns the matching Pydio Cells API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Pydio Cells API have?

The Pydio Cells API exposes 43 endpoints covering a operations.

### Can I limit what my agent is allowed to do with the Pydio Cells API?

Yes. Jentic One is self-hosted, so your own rules decide which Pydio Cells operations and credentials the agent may use. You can scope it to read-only calls like GET `/a/tree/stat/{Node}` for node metadata and GET `/a/user/{Login}` for user lookups, while leaving out the request-body operations that create, delete, or restore nodes. Because you choose the allowed set, POST `/a/tree/delete` is never callable unless you explicitly add it.