GraphQL API
Pylo's public API is built using GraphQL. It's the same API we use internally for the admin panel, giving you full access to all features.
Endpoint
All GraphQL requests are made to your Pylo instance's GraphQL endpoint:
https://api.pyloapp.com/graphql
Authentication
All requests require authentication — either a JWT via the login endpoint or an API token created in the admin panel. See Authentication for details.
Making Requests
Send a POST request with your GraphQL query in the body:
terminal
1
2
3
4
curl -X POST https://api.pyloapp.com/graphql \
-H "Content-Type: application/json" \
-H "pylo-api-key: YOUR_API_KEY" \
-d '{ "query": "query { health { data { up } } }"}'Dynamic Entities
Pylo generates GraphQL operations for each entity you define:
| Operation | Pattern | Example |
|---|---|---|
| List query | {entity}List | customerList |
| By-ID query | {entity}ById | customerById |
| Create mutation | create{Entity} | createCustomer |
| Update mutation | update{Entity} | updateCustomer |
| Delete mutation | delete{Entity} | deleteCustomer |
System Entities
Pylo includes built-in system entities that follow the same patterns:
| Entity | Description |
|---|---|
PyloUser | User accounts and authentication |
PyloMedia | Files and media uploads |
PyloApiKey | API tokens for programmatic access |
PyloApp | Application configuration |