For Agents
Server-side Appwrite surface authenticated by an admin API key: full /users administration, /projects configuration, /functions, /database, /storage. 95 endpoints.
Get started with Appwrite in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create an Appwrite user as admin"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Appwrite API.
Create, list, update, and delete user accounts admin-side via /users
Configure projects, OAuth providers, and webhooks via /projects
Read and write any document in any collection regardless of per-user rules
Upload, read, and delete files in any storage bucket regardless of bucket permissions
GET STARTED
Use for: I want to create a user account programmatically as an admin, Delete a user and all of their sessions, Configure a new OAuth2 provider on an Appwrite project, Deploy a new version of a cloud function with a tag
Not supported: Does not run on the client side or accept user session JWTs — use the Appwrite Client API for user-context calls; this server API requires an admin key only.
Jentic publishes the only available OpenAPI document for Appwrite, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Appwrite, keeping it validated and agent-ready. This is the server-side surface of the Appwrite open-source backend-as-a-service — 95 operations across 65 paths exercised with an admin API key. It includes admin operations on /users, project-level configuration under /projects, server-side function management at /functions, and full read/write access to /database and /storage that bypasses per-user permission rules. Use this from trusted server code, never from the browser or a mobile client.
Manage cloud functions including code deployment, tags, and execution at scale
Read /health endpoints to monitor self-hosted Appwrite deployment status
Administer team rosters and role assignments without acting as a member
Patterns agents use Appwrite API for, with concrete tasks.
★ Backend-Side User Administration
An internal admin tool uses the Appwrite Server API to create test users, reset passwords for support cases, suspend abusive accounts, and bulk-import users from a CSV. Server-key calls bypass user session requirements, so the tool can act on any account. The /users endpoint group covers create, list, update, delete, and session revocation operations.
POST /users with an email, password, and name to create a new user, then DELETE /users/{userId}/sessions to invalidate any existing sessions
CI Function Deployment
A CI pipeline deploys new versions of Appwrite cloud functions on every merge to main. The Server API exposes /functions for create and update, /functions/{functionId}/tags for code uploads, and /functions/{functionId}/executions for smoke tests. The full deploy-and-verify cycle runs from a CI job using only the project's admin key.
POST /functions/{functionId}/tags with the new function code, then POST /functions/{functionId}/executions to verify it runs
Project Configuration as Code
Teams keep their Appwrite project configuration — OAuth providers, webhooks, platform allowlists, JWT settings — under version control and apply changes through the /projects API. This makes project setup reproducible across staging and production without clicking through the Appwrite console for each environment.
POST /projects/{projectId}/webhooks with name, URL, and events list including database.documents.create
AI Agent Server-Side Automation
An AI agent with delegated server-key access uses Jentic to perform administrative work — provisioning users for a new tenant, deploying function code, writing audit logs into a privileged collection. Because the server API key has full access, Jentic's vault isolation is critical: the key stays in the MAXsystem vault and the agent only sees scoped credentials at execution time.
Search Jentic for 'create appwrite user as admin', call POST /users, then POST /teams/{teamId}/memberships to add the user to the tenant team
95 endpoints — jentic publishes the only available openapi specification for appwrite, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/users
Create a new user account admin-side
/users
List all users in the project
/projects/{projectId}/webhooks
Configure a webhook on a project
/functions/{functionId}/tags
Upload a new code tag for a function
/functions/{functionId}/executions
Execute a function with a payload
/storage/files
Upload a file to any storage bucket
/health
Read the overall health status of the Appwrite instance
/users
Create a new user account admin-side
/users
List all users in the project
/projects/{projectId}/webhooks
Configure a webhook on a project
/functions/{functionId}/tags
Upload a new code tag for a function
/functions/{functionId}/executions
Execute a function with a payload
Three things that make agents converge on Jentic-routed access.
Credential isolation
The X-Appwrite-Key is a powerful, scoped admin key. Jentic stores it encrypted in the MAXsystem vault, scopes its use to specific operations, and only attaches it at execution time, which dramatically reduces the blast radius of agent compromise.
Intent-based discovery
Agents search Jentic with intents like 'create appwrite user' or 'deploy appwrite function' and Jentic returns the matching server-surface operation with parameters and response schema, so the agent calls the right endpoint without scrolling docs.
Time to first call
Direct integration: 1-2 days to wire admin auth, function deployment, and webhook setup. Through Jentic: under 1 hour — search, load, execute against 95 already-modeled operations.
Alternatives and complements available in the Jentic catalogue.
Appwrite Client API
User-session surface that pairs with this admin server surface
Use the client slug when acting as a specific user with a JWT; use this server slug when an admin key is required.
Supabase API
Postgres-backed BaaS with a similar service-role-key admin surface
Pick Supabase when SQL is preferred; pick Appwrite Server for document storage and Appwrite-native functions.
Firebase API
Google's BaaS with the Firebase Admin SDK as the admin equivalent
Pick Firebase when targeting Google Cloud; pick Appwrite Server for self-hosted or open-source deployment.
Specific to using Appwrite API through Jentic.
Why is there no official OpenAPI spec for Appwrite?
Appwrite does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Appwrite via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Appwrite Server API use?
It uses two headers: X-Appwrite-Project (the project id) and X-Appwrite-Key (a server API key generated from the Appwrite console with explicit scopes). The key bypasses per-user rules, so it must never be exposed to client-side code. Through Jentic the key stays vaulted and is attached at execution time only.
Can I create users without a sign-up flow?
Yes. POST /users creates a user record directly with email, password, and optional name; the user can log in afterward via the client surface. This is the standard pattern for migrating users from another auth system or pre-creating accounts for invited tenants.
What are the rate limits for the Appwrite Server API?
Self-hosted Appwrite is bounded by your server's capacity. Appwrite Cloud applies plan-based quotas covering bandwidth, storage, function executions, and database operations. Server-key calls share the project quota with client-key calls; there is no separate admin allowance.
How do I deploy a new function tag through Jentic?
Run pip install jentic, search 'deploy appwrite function', and load POST /functions/{functionId}/tags. Execute it with the function id, command, and code archive. Jentic injects the X-Appwrite-Key from the vault and returns the new tag id.
Is the Appwrite Server API free?
Self-hosted Appwrite is fully open source under BSD-3-Clause and free. Appwrite Cloud has a free tier for hobby projects plus Pro and Scale paid plans for production usage; the server API is included on every plan.
/storage/files
Upload a file to any storage bucket
/health
Read the overall health status of the Appwrite instance