just/mocks_
mockzilla.org →
Catalog /backend /Appwrite Server API

Appwrite Server API

PROVIDER · Appwrite SPEC v1.5.0 · OpenAPI 3.0.0 MOCK · LIVE
▸ TRY IT
https://api.justmocks.com/appwrite-server
Open mock →

Emulate the Appwrite Server API in seconds. Appwrite backend as a service cuts up to 70% of the time and costs required for building a modern application.

[01]

About

overview

Mock the Appwrite Server API as a turnkey Mockzilla sim with 259 OpenAPI endpoints, realistic JSON payloads, no upstream signup or sandbox keys. Appwrite backend as a service cuts up to 70% of the time and costs required for building a modern application. Methods: 103x GET, 65x POST, 48x PATCH, 26x DELETE, 17x PUT. Top resource groups: messaging, account, databases, users. Hit https://api.justmocks.com/appwrite-server for the Mockzilla API Explorer landing and per-endpoint sample requests.

Endpoints
259 across 11 resource groups
Methods
GET 103 · POST 65 · PUT 17 · PATCH 48 · DEL 26 none deprecated
OpenAPI
3.0.0 spec version 1.5.0
Source spec
590 KB · YAML
[02]

Endpoints

259 operations · 11 resource groups
GET /account
account
Get account
Get the currently logged in user. Mocked via Mockzilla.
POST /account
account
Create account
Use this endpoint to allow a new user to register a new account in your project. After the user registration completes successfully, you can use the /account/verfication route to start verifying the user email address. To allow the new user to login to their new account, you need to create a new account session.
PATCH /account/email
account
Update email
Update currently logged in user account email address. After changing user address, the user confirmation status will get reset. A new confirmation email is not sent automatically however you can use the send confirmation email endpoint again to send the confirmation email. For security measures, user password is required to complete this request. This endpoint can also be used to convert an anonymous account to a normal one, by passing an email address and a new password.
GET /account/identities
account
List Identities
Get the list of identities for the currently logged in user.
DEL /account/identities/{identityId}
account
Delete identity
Delete an identity by its unique ID.
POST /account/jwt
account
Create JWT
Use this endpoint to create a JSON Web Token. You can use the resulting JWT to authenticate on behalf of the current user when working with the Appwrite server-side API and SDKs. The JWT secret is valid for 15 minutes from its creation and will be invalid if the user will logout in that time frame. Available as a Mockzilla mock endpoint.
GET /account/logs
account
List logs
Get the list of latest security activity logs for the currently logged in user. Each log returns user IP address, location and date and time of log.
PATCH /account/mfa
account
Update MFA
Enable or disable MFA on an account.
POST /account/mfa/authenticators/{type}
account
Add Authenticator
Add an authenticator app to be used as an MFA factor. Verify the authenticator using the verify authenticator method.
PUT /account/mfa/authenticators/{type}
account
Verify Authenticator
Verify an authenticator app after adding it using the add authenticator method.
DEL /account/mfa/authenticators/{type}
account
Delete Authenticator
Delete an authenticator for a user by ID. Mockzilla mock: no signup, no API key.
POST /account/mfa/challenge
account
Create 2FA Challenge
Begin the process of MFA verification after sign-in. Finish the flow with updateMfaChallenge method.
PUT /account/mfa/challenge
account
Create MFA Challenge (confirmation)
Complete the MFA challenge by providing the one-time password. Finish the process of MFA verification by providing the one-time password. To begin the flow, use createMfaChallenge method.
GET /account/mfa/factors
account
List Factors
List the factors available on the account to be used as a MFA challange.
GET /account/mfa/recovery-codes
account
Get MFA Recovery Codes
Get recovery codes that can be used as backup for MFA flow. Before getting codes, they must be generated using createMfaRecoveryCodes method. An OTP challenge is required to read recovery codes.
POST /account/mfa/recovery-codes
account
Create MFA Recovery Codes
Generate recovery codes as backup for MFA flow. It's recommended to generate and show then immediately after user successfully adds their authehticator. Recovery codes can be used as a MFA verification type in createMfaChallenge method. Served by the Mockzilla mock runtime.
PATCH /account/mfa/recovery-codes
account
Regenerate MFA Recovery Codes
Regenerate recovery codes that can be used as backup for MFA flow. Before regenerating codes, they must be first generated using createMfaRecoveryCodes method. An OTP challenge is required to regenreate recovery codes.
PATCH /account/name
account
Update name
Update currently logged in user account name.
PATCH /account/password
account
Update password
Update currently logged in user password. For validation, user is required to pass in the new password, and the old password. For users created with OAuth, Team Invites and Magic URL, oldPassword is optional.
PATCH /account/phone
account
Update phone
Update the currently logged in user's phone number. After updating the phone number, the phone verification status will be reset. A confirmation SMS is not sent automatically, however you can use the POST /account/verification/phone endpoint to send a confirmation SMS.
GET /account/prefs
account
Get account preferences
Get the preferences as a key-value object for the currently logged in user. Mocked via Mockzilla.
PATCH /account/prefs
account
Update preferences
Update currently logged in user account preferences. The object you pass is stored as is, and replaces any previous value. The maximum allowed prefs size is 64kB and throws error if exceeded.
POST /account/recovery
account
Create password recovery
Sends the user an email with a temporary secret key for password reset. When the user clicks the confirmation link he is redirected back to your app password reset URL with the secret key and email address values attached to the URL query string. Use the query string params to submit a request to the PUT /account/recovery endpoint to complete the process. The verification link sent to the user's email address is valid for 1 hour.
PUT /account/recovery
account
Create password recovery (confirmation)
Use this endpoint to complete the user account password reset. Both the userId and secret arguments will be passed as query parameters to the redirect URL you have provided when sending your request to the POST /account/recovery endpoint. Please note that in order to avoid a Redirect Attack the only valid redirect URLs are the ones from domains you have set when adding your platforms in the console interface.
GET /account/sessions
account
List sessions
Get the list of active sessions across different devices for the currently logged in user.
DEL /account/sessions
account
Delete sessions
Delete all sessions from the user account and remove any sessions cookies from the end client. Available as a Mockzilla mock endpoint.
POST /account/sessions/anonymous
account
Create anonymous session
Use this endpoint to allow a new user to register an anonymous account in your project. This route will also create a new session for the user. To allow the new user to convert an anonymous account to a normal account, you need to update its email and password or create an OAuth2 session.
POST /account/sessions/email
account
Create email password session
Allow the user to login into their account by providing a valid email and password combination. This route will create a new session for the user. A user is limited to 10 active sessions at a time by default. Learn more about session limits.
PUT /account/sessions/magic-url
account
Update magic URL session
Use this endpoint to create a session from token. Provide the userId and secret parameters from the successful response of authentication flows initiated by token creation. For example, magic URL and phone login.
PUT /account/sessions/phone
account
Update phone session
Use this endpoint to create a session from token. Provide the userId and secret parameters from the successful response of authentication flows initiated by token creation. For example, magic URL and phone login.
POST /account/sessions/token
account
Create session
Use this endpoint to create a session from token. Provide the userId and secret parameters from the successful response of authentication flows initiated by token creation. For example, magic URL and phone login. Mockzilla mock: no signup, no API key.
GET /account/sessions/{sessionId}
account
Get session
Use this endpoint to get a logged in user's session using a Session ID. Inputting 'current' will return the current session being used.
PATCH /account/sessions/{sessionId}
account
Update session
Use this endpoint to extend a session's length. Extending a session is useful when session expiry is short. If the session was created using an OAuth provider, this endpoint refreshes the access token from the provider.
DEL /account/sessions/{sessionId}
account
Delete session
Logout the user. Use 'current' as the session ID to logout on this device, use a session ID to logout on another device. If you're looking to logout the user on all devices, use Delete Sessions instead.
PATCH /account/status
account
Update status
Block the currently logged in user account. Behind the scene, the user record is not deleted but permanently blocked from any access. To completely delete a user, use the Users API instead.
POST /account/tokens/email
account
Create email token (OTP)
Sends the user an email with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the POST /v1/account/sessions/token endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes. A user is limited to 10 active sessions at a time by default. Learn more about session limits. Served by the Mockzilla mock runtime.
POST /account/tokens/magic-url
account
Create magic URL token
Sends the user an email with a secret key for creating a session. If the provided user ID has not been registered, a new user will be created. When the user clicks the link in the email, the user is redirected back to the URL you provided with the secret key and userId values attached to the URL query string. Use the query string parameters to submit a request to the POST /v1/account/sessions/token endpoint to complete the login process. The link sent to the user's email address is valid for 1 hour. If you are on a mobile device you can leave the URL parameter empty, so that the login completion will be handled by your Appwrite instance by default. A user is limited to 10 active sessions at a time by default. Learn more about session limits.
GET /account/tokens/oauth2/{provider}
account
Create OAuth2 token
Allow the user to login to their account using the OAuth2 provider of their choice. Each OAuth2 provider should be enabled from the Appwrite console first. Use the success and failure arguments to provide a redirect URL's back to your app when login is completed. If authentication succeeds, userId and secret of a token will be appended to the success URL as query parameters. These can be used to create a new session using the Create session endpoint. A user is limited to 10 active sessions at a time by default. Learn more about session limits.
POST /account/tokens/phone
account
Create phone token
Sends the user an SMS with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the POST /v1/account/sessions/token endpoint to complete the login process. The secret sent to the user's phone is valid for 15 minutes. A user is limited to 10 active sessions at a time by default. Learn more about session limits.
POST /account/verification
account
Create email verification
Use this endpoint to send a verification message to your user email address to confirm they are the valid owners of that address. Both the userId and secret arguments will be passed as query parameters to the URL you have provided to be attached to the verification email. The provided URL should redirect the user back to your app and allow you to complete the verification process by verifying both the userId and secret parameters. Learn more about how to complete the verification process. The verification link sent to the user's email address is valid for 7 days. Please note that in order to avoid a Redirect Attack, the only valid redirect URLs are the ones from domains you have set when adding your platforms in the console interface.
PUT /account/verification
account
Create email verification (confirmation)
Use this endpoint to complete the user email verification process. Use both the userId and secret parameters that were attached to your app URL to verify the user email ownership. If confirmed this route will return a 200 status code. Mocked via Mockzilla.
POST /account/verification/phone
account
Create phone verification
Use this endpoint to send a verification SMS to the currently logged in user. This endpoint is meant for use after updating a user's phone number using the accountUpdatePhone endpoint. Learn more about how to complete the verification process. The verification code sent to the user's phone number is valid for 15 minutes.
PUT /account/verification/phone
account
Create phone verification (confirmation)
Use this endpoint to complete the user phone verification process. Use the userId and secret that were sent to your user's phone number to verify the user email ownership. If confirmed this route will return a 200 status code.
GET /avatars/browsers/{code}
avatars
Get browser icon
You can use this endpoint to show different browser icons to your users. The code argument receives the browser code as it appears in your user GET /account/sessions endpoint. Use width, height and quality arguments to change the output settings. When one dimension is specified and the other is 0, the image is scaled with preserved aspect ratio. If both dimensions are 0, the API provides an image at source quality. If dimensions are not specified, the default size of image returned is 100x100px.
GET /avatars/credit-cards/{code}
avatars
Get credit card icon
The credit card endpoint will return you the icon of the credit card provider you need. Use width, height and quality arguments to change the output settings. When one dimension is specified and the other is 0, the image is scaled with preserved aspect ratio. If both dimensions are 0, the API provides an image at source quality. If dimensions are not specified, the default size of image returned is 100x100px.
GET /avatars/favicon
avatars
Get favicon
Use this endpoint to fetch the favorite icon (AKA favicon) of any remote website URL. Available as a Mockzilla mock endpoint.
GET /avatars/flags/{code}
avatars
Get country flag
You can use this endpoint to show different country flags icons to your users. The code argument receives the 2 letter country code. Use width, height and quality arguments to change the output settings. Country codes follow the ISO 3166-1 standard. When one dimension is specified and the other is 0, the image is scaled with preserved aspect ratio. If both dimensions are 0, the API provides an image at source quality. If dimensions are not specified, the default size of image returned is 100x100px.
GET /avatars/image
avatars
Get image from URL
Use this endpoint to fetch a remote image URL and crop it to any image size you want. This endpoint is very useful if you need to crop and display remote images in your app or in case you want to make sure a 3rd party image is properly served using a TLS protocol. When one dimension is specified and the other is 0, the image is scaled with preserved aspect ratio. If both dimensions are 0, the API provides an image at source quality. If dimensions are not specified, the default size of image returned is 400x400px.
GET /avatars/initials
avatars
Get user initials
Use this endpoint to show your user initials avatar icon on your website or app. By default, this route will try to print your logged-in user name or email initials. You can also overwrite the user name if you pass the 'name' parameter. If no name is given and no user is logged, an empty avatar will be returned. You can use the color and background params to change the avatar colors. By default, a random theme will be selected. The random theme will persist for the user's initials when reloading the same theme will always return for the same initials. When one dimension is specified and the other is 0, the image is scaled with preserved aspect ratio. If both dimensions are 0, the API provides an image at source quality. If dimensions are not specified, the default size of image returned is 100x100px.
GET /avatars/qr
avatars
Get QR code
Converts a given plain text to a QR code image. You can use the query parameters to change the size and style of the resulting image.
GET /databases
databases
List databases
Get a list of all databases from the current Appwrite project. You can use the search parameter to filter your results. Mockzilla mock: no signup, no API key.
POST /databases
databases
Create database
Create a new Database.
GET /databases/{databaseId}
databases
Get database
Get a database by its unique ID. This endpoint response returns a JSON object with the database metadata.
PUT /databases/{databaseId}
databases
Update database
Update a database by its unique ID.
DEL /databases/{databaseId}
databases
Delete database
Delete a database by its unique ID. Only API keys with with databases.write scope can delete a database.
GET /databases/{databaseId}/collections
databases
List collections
Get a list of all collections that belong to the provided databaseId. You can use the search parameter to filter your results. Served by the Mockzilla mock runtime.
POST /databases/{databaseId}/collections
databases
Create collection
Create a new Collection. Before using this route, you should create a new database resource using either a server integration API or directly from your database console.
GET /databases/{databaseId}/collections/{collectionId}
databases
Get collection
Get a collection by its unique ID. This endpoint response returns a JSON object with the collection metadata.
PUT /databases/{databaseId}/collections/{collectionId}
databases
Update collection
Update a collection by its unique ID.
DEL /databases/{databaseId}/collections/{collectionId}
databases
Delete collection
Delete a collection by its unique ID. Only users with write permissions have access to delete this resource.
GET /databases/{databaseId}/collections/{collectionId}/attributes
databases
List attributes
List attributes in the collection. Mocked via Mockzilla.
POST /databases/{databaseId}/collections/{collectionId}/attributes/boolean
databases
Create boolean attribute
Create a boolean attribute.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/boolean/{key}
databases
Update boolean attribute
Update a boolean attribute. Changing the default value will not update already existing documents.
POST /databases/{databaseId}/collections/{collectionId}/attributes/datetime
databases
Create datetime attribute
Create a date time attribute according to the ISO 8601 standard.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/datetime/{key}
databases
Update dateTime attribute
Update a date time attribute. Changing the default value will not update already existing documents.
POST /databases/{databaseId}/collections/{collectionId}/attributes/email
databases
Create email attribute
Create an email attribute. Available as a Mockzilla mock endpoint.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/email/{key}
databases
Update email attribute
Update an email attribute. Changing the default value will not update already existing documents.
POST /databases/{databaseId}/collections/{collectionId}/attributes/enum
databases
Create enum attribute
Create an enumeration attribute. The elements param acts as a white-list of accepted values for this attribute.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/enum/{key}
databases
Update enum attribute
Update an enum attribute. Changing the default value will not update already existing documents.
POST /databases/{databaseId}/collections/{collectionId}/attributes/float
databases
Create float attribute
Create a float attribute. Optionally, minimum and maximum values can be provided.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/float/{key}
databases
Update float attribute
Update a float attribute. Changing the default value will not update already existing documents. Mockzilla mock: no signup, no API key.
POST /databases/{databaseId}/collections/{collectionId}/attributes/integer
databases
Create integer attribute
Create an integer attribute. Optionally, minimum and maximum values can be provided.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/integer/{key}
databases
Update integer attribute
Update an integer attribute. Changing the default value will not update already existing documents.
POST /databases/{databaseId}/collections/{collectionId}/attributes/ip
databases
Create IP address attribute
Create IP address attribute.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/ip/{key}
databases
Update IP address attribute
Update an ip attribute. Changing the default value will not update already existing documents.
POST /databases/{databaseId}/collections/{collectionId}/attributes/relationship
databases
Create relationship attribute
Create relationship attribute. Learn more about relationship attributes. Served by the Mockzilla mock runtime.
POST /databases/{databaseId}/collections/{collectionId}/attributes/string
databases
Create string attribute
Create a string attribute.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/string/{key}
databases
Update string attribute
Update a string attribute. Changing the default value will not update already existing documents.
POST /databases/{databaseId}/collections/{collectionId}/attributes/url
databases
Create URL attribute
Create a URL attribute.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/url/{key}
databases
Update URL attribute
Update an url attribute. Changing the default value will not update already existing documents.
GET /databases/{databaseId}/collections/{collectionId}/attributes/{key}
databases
Get attribute
Get attribute by ID. Mocked via Mockzilla.
DEL /databases/{databaseId}/collections/{collectionId}/attributes/{key}
databases
Delete attribute
Deletes an attribute.
PATCH /databases/{databaseId}/collections/{collectionId}/attributes/{key}/relationship
databases
Update relationship attribute
Update relationship attribute. Learn more about relationship attributes.
GET /databases/{databaseId}/collections/{collectionId}/documents
databases
List documents
Get a list of all the user's documents in a given collection. You can use the query params to filter your results.
POST /databases/{databaseId}/collections/{collectionId}/documents
databases
Create document
Create a new Document. Before using this route, you should create a new collection resource using either a server integration API or directly from your database console.
GET /databases/{databaseId}/collections/{collectionId}/documents/{documentId}
databases
Get document
Get a document by its unique ID. This endpoint response returns a JSON object with the document data. Available as a Mockzilla mock endpoint.
PATCH /databases/{databaseId}/collections/{collectionId}/documents/{documentId}
databases
Update document
Update a document by its unique ID. Using the patch method you can pass only specific fields that will get updated.
DEL /databases/{databaseId}/collections/{collectionId}/documents/{documentId}
databases
Delete document
Delete a document by its unique ID.
GET /databases/{databaseId}/collections/{collectionId}/indexes
databases
List indexes
List indexes in the collection.
POST /databases/{databaseId}/collections/{collectionId}/indexes
databases
Create index
Creates an index on the attributes listed. Your index should include all the attributes you will query in a single request. Attributes can be key, fulltext, and unique.
GET /databases/{databaseId}/collections/{collectionId}/indexes/{key}
databases
Get index
Get index by ID. Mockzilla mock: no signup, no API key.
DEL /databases/{databaseId}/collections/{collectionId}/indexes/{key}
databases
Delete index
Delete an index.
GET /functions
functions
List functions
Get a list of all the project's functions. You can use the query params to filter your results.
POST /functions
functions
Create function
Create a new function. You can pass a list of permissions to allow different project users or team with access to execute the function using the client API.
GET /functions/runtimes
functions
List runtimes
Get a list of all runtimes that are currently active on your instance.
GET /functions/{functionId}
functions
Get function
Get a function by its unique ID. Served by the Mockzilla mock runtime.
PUT /functions/{functionId}
functions
Update function
Update function by its unique ID.
DEL /functions/{functionId}
functions
Delete function
Delete a function by its unique ID.
GET /functions/{functionId}/deployments
functions
List deployments
Get a list of all the project's code deployments. You can use the query params to filter your results.
POST /functions/{functionId}/deployments
functions
Create deployment
Create a new function code deployment. Use this endpoint to upload a new version of your code function. To execute your newly uploaded code, you'll need to update the function's deployment to use your new deployment UID. This endpoint accepts a tar.gz file compressed with your code. Make sure to include any dependencies your code has within the compressed file. You can learn more about code packaging in the Appwrite Cloud Functions tutorial. Use the "command" param to set the entrypoint used to execute your code.
GET /functions/{functionId}/deployments/{deploymentId}
functions
Get deployment
Get a code deployment by its unique ID. Mocked via Mockzilla.
PATCH /functions/{functionId}/deployments/{deploymentId}
functions
Update function deployment
Update the function code deployment ID using the unique function ID. Use this endpoint to switch the code deployment that should be executed by the execution endpoint.
DEL /functions/{functionId}/deployments/{deploymentId}
functions
Delete deployment
Delete a code deployment by its unique ID.
POST /functions/{functionId}/deployments/{deploymentId}/builds/{buildId}
functions
Create build
Create a new build for an Appwrite Function deployment. This endpoint can be used to retry a failed build.
GET /functions/{functionId}/deployments/{deploymentId}/download
functions
Download Deployment
Get a Deployment's contents by its unique ID. This endpoint supports range requests for partial or streaming file download.
GET /functions/{functionId}/executions
functions
List executions
Get a list of all the current user function execution logs. You can use the query params to filter your results. Available as a Mockzilla mock endpoint.
POST /functions/{functionId}/executions
functions
Create execution
Trigger a function execution. The returned object will return you the current execution status. You can ping the Get Execution endpoint to get updates on the current execution status. Once this endpoint is called, your function execution process will start asynchronously.
GET /functions/{functionId}/executions/{executionId}
functions
Get execution
Get a function execution log by its unique ID.
GET /functions/{functionId}/variables
functions
List variables
Get a list of all variables of a specific function.
POST /functions/{functionId}/variables
functions
Create variable
Create a new function environment variable. These variables can be accessed in the function at runtime as environment variables.
GET /functions/{functionId}/variables/{variableId}
functions
Get variable
Get a variable by its unique ID. Mockzilla mock: no signup, no API key.
PUT /functions/{functionId}/variables/{variableId}
functions
Update variable
Update variable by its unique ID.
DEL /functions/{functionId}/variables/{variableId}
functions
Delete variable
Delete a variable by its unique ID.
POST /graphql
graphql
GraphQL endpoint
Execute a GraphQL mutation.
POST /graphql/mutation
graphql
GraphQL endpoint
Execute a GraphQL mutation.
GET /health
health
Get HTTP
Check the Appwrite HTTP server is up and responsive. Served by the Mockzilla mock runtime.
GET /health/anti-virus
health
Get antivirus
Check the Appwrite Antivirus server is up and connection is successful.
GET /health/cache
health
Get cache
Check the Appwrite in-memory cache servers are up and connection is successful.
GET /health/certificate
health
Get the SSL certificate for a domain
Get the SSL certificate for a domain
GET /health/db
health
Get DB
Check the Appwrite database servers are up and connection is successful.
GET /health/pubsub
health
Get pubsub
Check the Appwrite pub-sub servers are up and connection is successful. Mocked via Mockzilla.
GET /health/queue
health
Get queue
Check the Appwrite queue messaging servers are up and connection is successful.
GET /health/queue/builds
health
Get builds queue
Get the number of builds that are waiting to be processed in the Appwrite internal queue server.
GET /health/queue/certificates
health
Get certificates queue
Get the number of certificates that are waiting to be issued against Letsencrypt in the Appwrite internal queue server.
GET /health/queue/databases
health
Get databases queue
Get the number of database changes that are waiting to be processed in the Appwrite internal queue server.
GET /health/queue/deletes
health
Get deletes queue
Get the number of background destructive changes that are waiting to be processed in the Appwrite internal queue server. Available as a Mockzilla mock endpoint.
GET /health/queue/failed/{name}
health
Get number of failed queue jobs
Returns the amount of failed jobs in a given queue.
GET /health/queue/functions
health
Get functions queue
Get the number of function executions that are waiting to be processed in the Appwrite internal queue server.
GET /health/queue/logs
health
Get logs queue
Get the number of logs that are waiting to be processed in the Appwrite internal queue server.
GET /health/queue/mails
health
Get mails queue
Get the number of mails that are waiting to be processed in the Appwrite internal queue server.
GET /health/queue/messaging
health
Get messaging queue
Get the number of messages that are waiting to be processed in the Appwrite internal queue server. Mockzilla mock: no signup, no API key.
GET /health/queue/migrations
health
Get migrations queue
Get the number of migrations that are waiting to be processed in the Appwrite internal queue server.
GET /health/queue/usage
health
Get usage queue
Get the number of metrics that are waiting to be processed in the Appwrite internal queue server.
GET /health/queue/usage-dump
health
Get usage dump queue
Get the number of projects containing metrics that are waiting to be processed in the Appwrite internal queue server.
GET /health/queue/webhooks
health
Get webhooks queue
Get the number of webhooks that are waiting to be processed in the Appwrite internal queue server.
GET /health/storage
health
Get storage
Check the Appwrite storage device is up and connection is successful. Served by the Mockzilla mock runtime.
GET /health/storage/local
health
Get local storage
Check the Appwrite local storage device is up and connection is successful.
GET /health/time
health
Get time
Check the Appwrite server time is synced with Google remote NTP server. We use this technology to smoothly handle leap seconds with no disruptive events. The Network Time Protocol (NTP) is used by hundreds of millions of computers and devices to synchronize their clocks over the Internet. If your computer sets its own clock, it likely uses NTP.
GET /locale
locale
Get user locale
Get the current user location based on IP. Returns an object with user country code, country name, continent name, continent code, ip address and suggested currency. You can use the locale header to get the data in a supported language. (IP Geolocation by DB-IP)
GET /locale/codes
locale
List Locale Codes
List of all locale codes in ISO 639-1.
GET /locale/continents
locale
List continents
List of all continents. You can use the locale header to get the data in a supported language. Mocked via Mockzilla.
GET /locale/countries
locale
List countries
List of all countries. You can use the locale header to get the data in a supported language.
GET /locale/countries/eu
locale
List EU countries
List of all countries that are currently members of the EU. You can use the locale header to get the data in a supported language.
GET /locale/countries/phones
locale
List countries phone codes
List of all countries phone codes. You can use the locale header to get the data in a supported language.
GET /locale/currencies
locale
List currencies
List of all currencies, including currency symbol, name, plural, and decimal digits for all major and minor currencies. You can use the locale header to get the data in a supported language.
GET /locale/languages
locale
List languages
List of all languages classified by ISO 639-1 including 2-letter code, name in English, and name in the respective language. Available as a Mockzilla mock endpoint.
GET /messaging/messages
messaging
List messages
Get a list of all messages from the current Appwrite project.
POST /messaging/messages/email
messaging
Create email
Create a new email message.
PATCH /messaging/messages/email/{messageId}
messaging
Update email
Update an email message by its unique ID.
POST /messaging/messages/push
messaging
Create push notification
Create a new push notification.
PATCH /messaging/messages/push/{messageId}
messaging
Update push notification
Update a push notification by its unique ID. Mockzilla mock: no signup, no API key.
POST /messaging/messages/sms
messaging
Create SMS
Create a new SMS message.
PATCH /messaging/messages/sms/{messageId}
messaging
Update SMS
Update an email message by its unique ID.
GET /messaging/messages/{messageId}
messaging
Get message
Get a message by its unique ID.
DEL /messaging/messages/{messageId}
messaging
Delete message
Delete a message. If the message is not a draft or scheduled, but has been sent, this will not recall the message.
GET /messaging/messages/{messageId}/logs
messaging
List message logs
Get the message activity logs listed by its unique ID. Served by the Mockzilla mock runtime.
GET /messaging/messages/{messageId}/targets
messaging
List message targets
Get a list of the targets associated with a message.
GET /messaging/providers
messaging
List providers
Get a list of all providers from the current Appwrite project.
POST /messaging/providers/apns
messaging
Create APNS provider
Create a new Apple Push Notification service provider.
PATCH /messaging/providers/apns/{providerId}
messaging
Update APNS provider
Update a Apple Push Notification service provider by its unique ID.
POST /messaging/providers/fcm
messaging
Create FCM provider
Create a new Firebase Cloud Messaging provider. Mocked via Mockzilla.
PATCH /messaging/providers/fcm/{providerId}
messaging
Update FCM provider
Update a Firebase Cloud Messaging provider by its unique ID.
POST /messaging/providers/mailgun
messaging
Create Mailgun provider
Create a new Mailgun provider.
PATCH /messaging/providers/mailgun/{providerId}
messaging
Update Mailgun provider
Update a Mailgun provider by its unique ID.
POST /messaging/providers/msg91
messaging
Create Msg91 provider
Create a new MSG91 provider.
PATCH /messaging/providers/msg91/{providerId}
messaging
Update Msg91 provider
Update a MSG91 provider by its unique ID. Available as a Mockzilla mock endpoint.
POST /messaging/providers/sendgrid
messaging
Create Sendgrid provider
Create a new Sendgrid provider.
PATCH /messaging/providers/sendgrid/{providerId}
messaging
Update Sendgrid provider
Update a Sendgrid provider by its unique ID.
POST /messaging/providers/smtp
messaging
Create SMTP provider
Create a new SMTP provider.
PATCH /messaging/providers/smtp/{providerId}
messaging
Update SMTP provider
Update a SMTP provider by its unique ID.
POST /messaging/providers/telesign
messaging
Create Telesign provider
Create a new Telesign provider. Mockzilla mock: no signup, no API key.
PATCH /messaging/providers/telesign/{providerId}
messaging
Update Telesign provider
Update a Telesign provider by its unique ID.
POST /messaging/providers/textmagic
messaging
Create Textmagic provider
Create a new Textmagic provider.
PATCH /messaging/providers/textmagic/{providerId}
messaging
Update Textmagic provider
Update a Textmagic provider by its unique ID.
POST /messaging/providers/twilio
messaging
Create Twilio provider
Create a new Twilio provider.
PATCH /messaging/providers/twilio/{providerId}
messaging
Update Twilio provider
Update a Twilio provider by its unique ID. Served by the Mockzilla mock runtime.
POST /messaging/providers/vonage
messaging
Create Vonage provider
Create a new Vonage provider.
PATCH /messaging/providers/vonage/{providerId}
messaging
Update Vonage provider
Update a Vonage provider by its unique ID.
GET /messaging/providers/{providerId}
messaging
Get provider
Get a provider by its unique ID.
DEL /messaging/providers/{providerId}
messaging
Delete provider
Delete a provider by its unique ID.
GET /messaging/providers/{providerId}/logs
messaging
List provider logs
Get the provider activity logs listed by its unique ID. Mocked via Mockzilla.
GET /messaging/subscribers/{subscriberId}/logs
messaging
List subscriber logs
Get the subscriber activity logs listed by its unique ID.
GET /messaging/topics
messaging
List topics
Get a list of all topics from the current Appwrite project.
POST /messaging/topics
messaging
Create topic
Create a new topic.
GET /messaging/topics/{topicId}
messaging
Get topic
Get a topic by its unique ID.
PATCH /messaging/topics/{topicId}
messaging
Update topic
Update a topic by its unique ID. Available as a Mockzilla mock endpoint.
DEL /messaging/topics/{topicId}
messaging
Delete topic
Delete a topic by its unique ID.
GET /messaging/topics/{topicId}/logs
messaging
List topic logs
Get the topic activity logs listed by its unique ID.
GET /messaging/topics/{topicId}/subscribers
messaging
List subscribers
Get a list of all subscribers from the current Appwrite project.
POST /messaging/topics/{topicId}/subscribers
messaging
Create subscriber
Create a new subscriber.
GET /messaging/topics/{topicId}/subscribers/{subscriberId}
messaging
Get subscriber
Get a subscriber by its unique ID. Mockzilla mock: no signup, no API key.
DEL /messaging/topics/{topicId}/subscribers/{subscriberId}
messaging
Delete subscriber
Delete a subscriber by its unique ID.
GET /storage/buckets
storage
List buckets
Get a list of all the storage buckets. You can use the query params to filter your results.
POST /storage/buckets
storage
Create bucket
Create a new storage bucket.
GET /storage/buckets/{bucketId}
storage
Get bucket
Get a storage bucket by its unique ID. This endpoint response returns a JSON object with the storage bucket metadata.
PUT /storage/buckets/{bucketId}
storage
Update bucket
Update a storage bucket by its unique ID. Served by the Mockzilla mock runtime.
DEL /storage/buckets/{bucketId}
storage
Delete bucket
Delete a storage bucket by its unique ID.
GET /storage/buckets/{bucketId}/files
storage
List files
Get a list of all the user files. You can use the query params to filter your results.
POST /storage/buckets/{bucketId}/files
storage
Create file
Create a new file. Before using this route, you should create a new bucket resource using either a server integration API or directly from your Appwrite console. Larger files should be uploaded using multiple requests with the content-range header to send a partial request with a maximum supported chunk of 5MB. The content-range header values should always be in bytes. When the first request is sent, the server will return the File object, and the subsequent part request must include the file's id in x-appwrite-id header to allow the server to know that the partial upload is for the existing file and not for a new one. If you're creating a new file using one of the Appwrite SDKs, all the chunking logic will be managed by the SDK internally.
GET /storage/buckets/{bucketId}/files/{fileId}
storage
Get file
Get a file by its unique ID. This endpoint response returns a JSON object with the file metadata.
PUT /storage/buckets/{bucketId}/files/{fileId}
storage
Update file
Update a file by its unique ID. Only users with write permissions have access to update this resource. Mocked via Mockzilla.
DEL /storage/buckets/{bucketId}/files/{fileId}
storage
Delete File
Delete a file by its unique ID. Only users with write permissions have access to delete this resource.
GET /storage/buckets/{bucketId}/files/{fileId}/download
storage
Get file for download
Get a file content by its unique ID. The endpoint response return with a 'Content-Disposition: attachment' header that tells the browser to start downloading the file to user downloads directory.
GET /storage/buckets/{bucketId}/files/{fileId}/preview
storage
Get file preview
Get a file preview image. Currently, this method supports preview for image files (jpg, png, and gif), other supported formats, like pdf, docs, slides, and spreadsheets, will return the file icon image. You can also pass query string arguments for cutting and resizing your preview image. Preview is supported only for image files smaller than 10MB.
GET /storage/buckets/{bucketId}/files/{fileId}/view
storage
Get file for view
Get a file content by its unique ID. This endpoint is similar to the download method but returns with no 'Content-Disposition: attachment' header.
GET /teams
teams
List teams
Get a list of all the teams in which the current user is a member. You can use the parameters to filter your results. Available as a Mockzilla mock endpoint.
POST /teams
teams
Create team
Create a new team. The user who creates the team will automatically be assigned as the owner of the team. Only the users with the owner role can invite new members, add new owners and delete or update the team.
GET /teams/{teamId}
teams
Get team
Get a team by its ID. All team members have read access for this resource.
PUT /teams/{teamId}
teams
Update name
Update the team's name by its unique ID.
DEL /teams/{teamId}
teams
Delete team
Delete a team using its ID. Only team members with the owner role can delete the team.
GET /teams/{teamId}/memberships
teams
List team memberships
Use this endpoint to list a team's members using the team's ID. All team members have read access to this endpoint. Mockzilla mock: no signup, no API key.
POST /teams/{teamId}/memberships
teams
Create team membership
Invite a new member to join your team. Provide an ID for existing users, or invite unregistered users using an email or phone number. If initiated from a Client SDK, Appwrite will send an email or sms with a link to join the team to the invited user, and an account will be created for them if one doesn't exist. If initiated from a Server SDK, the new member will be added automatically to the team. You only need to provide one of a user ID, email, or phone number. Appwrite will prioritize accepting the user ID > email > phone number if you provide more than one of these parameters. Use the url parameter to redirect the user from the invitation email to your app. After the user is redirected, use the Update Team Membership Status endpoint to allow the user to accept the invitation to the team. Please note that to avoid a Redirect Attack Appwrite will accept the only redirect URLs under the domains you have added as a platform on the Appwrite Console.
GET /teams/{teamId}/memberships/{membershipId}
teams
Get team membership
Get a team member by the membership unique id. All team members have read access for this resource.
PATCH /teams/{teamId}/memberships/{membershipId}
teams
Update membership
Modify the roles of a team member. Only team members with the owner role have access to this endpoint. Learn more about roles and permissions.
DEL /teams/{teamId}/memberships/{membershipId}
teams
Delete team membership
This endpoint allows a user to leave a team or for a team owner to delete the membership of any other team member. You can also use this endpoint to delete a user membership even if it is not accepted.
PATCH /teams/{teamId}/memberships/{membershipId}/status
teams
Update team membership status
Use this endpoint to allow a user to accept an invitation to join a team after being redirected back to your app from the invitation email received by the user. If the request is successful, a session for the user is automatically created. Served by the Mockzilla mock runtime.
GET /teams/{teamId}/prefs
teams
Get team preferences
Get the team's shared preferences by its unique ID. If a preference doesn't need to be shared by all team members, prefer storing them in user preferences.
PUT /teams/{teamId}/prefs
teams
Update preferences
Update the team's preferences by its unique ID. The object you pass is stored as is and replaces any previous value. The maximum allowed prefs size is 64kB and throws an error if exceeded.
GET /users
users
List users
Get a list of all the project's users. You can use the query params to filter your results.
POST /users
users
Create user
Create a new user.
POST /users/argon2
users
Create user with Argon2 password
Create a new user. Password provided must be hashed with the Argon2 algorithm. Use the POST /users endpoint to create users with a plain text password. Mocked via Mockzilla.
POST /users/bcrypt
users
Create user with bcrypt password
Create a new user. Password provided must be hashed with the Bcrypt algorithm. Use the POST /users endpoint to create users with a plain text password.
GET /users/identities
users
List Identities
Get identities for all users.
DEL /users/identities/{identityId}
users
Delete identity
Delete an identity by its unique ID.
POST /users/md5
users
Create user with MD5 password
Create a new user. Password provided must be hashed with the MD5 algorithm. Use the POST /users endpoint to create users with a plain text password.
POST /users/phpass
users
Create user with PHPass password
Create a new user. Password provided must be hashed with the PHPass algorithm. Use the POST /users endpoint to create users with a plain text password. Available as a Mockzilla mock endpoint.
POST /users/scrypt
users
Create user with Scrypt password
Create a new user. Password provided must be hashed with the Scrypt algorithm. Use the POST /users endpoint to create users with a plain text password.
POST /users/scrypt-modified
users
Create user with Scrypt modified password
Create a new user. Password provided must be hashed with the Scrypt Modified algorithm. Use the POST /users endpoint to create users with a plain text password.
POST /users/sha
users
Create user with SHA password
Create a new user. Password provided must be hashed with the SHA algorithm. Use the POST /users endpoint to create users with a plain text password.
GET /users/{userId}
users
Get user
Get a user by its unique ID.
DEL /users/{userId}
users
Delete user
Delete a user by its unique ID, thereby releasing it's ID. Since ID is released and can be reused, all user-related resources like documents or storage files should be deleted before user deletion. If you want to keep ID reserved, use the updateStatus endpoint instead. Mockzilla mock: no signup, no API key.
PATCH /users/{userId}/email
users
Update email
Update the user email by its unique ID.
PUT /users/{userId}/labels
users
Update user labels
Update the user labels by its unique ID. Labels can be used to grant access to resources. While teams are a way for user's to share access to a resource, labels can be defined by the developer to grant access without an invitation. See the Permissions docs for more info.
GET /users/{userId}/logs
users
List user logs
Get the user activity logs list by its unique ID.
GET /users/{userId}/memberships
users
List user memberships
Get the user membership list by its unique ID.
PATCH /users/{userId}/mfa
users
Update MFA
Enable or disable MFA on a user account. Served by the Mockzilla mock runtime.
DEL /users/{userId}/mfa/authenticators/{type}
users
Delete Authenticator
Delete an authenticator app.
GET /users/{userId}/mfa/factors
users
List Factors
List the factors available on the account to be used as a MFA challange.
GET /users/{userId}/mfa/recovery-codes
users
Get MFA Recovery Codes
Get recovery codes that can be used as backup for MFA flow by User ID. Before getting codes, they must be generated using createMfaRecoveryCodes method.
PUT /users/{userId}/mfa/recovery-codes
users
Regenerate MFA Recovery Codes
Regenerate recovery codes that can be used as backup for MFA flow by User ID. Before regenerating codes, they must be first generated using createMfaRecoveryCodes method.
PATCH /users/{userId}/mfa/recovery-codes
users
Create MFA Recovery Codes
Generate recovery codes used as backup for MFA flow for User ID. Recovery codes can be used as a MFA verification type in createMfaChallenge method by client SDK. Mocked via Mockzilla.
PATCH /users/{userId}/name
users
Update name
Update the user name by its unique ID.
PATCH /users/{userId}/password
users
Update password
Update the user password by its unique ID.
PATCH /users/{userId}/phone
users
Update phone
Update the user phone by its unique ID.
GET /users/{userId}/prefs
users
Get user preferences
Get the user preferences by its unique ID.
PATCH /users/{userId}/prefs
users
Update user preferences
Update the user preferences by its unique ID. The object you pass is stored as is, and replaces any previous value. The maximum allowed prefs size is 64kB and throws error if exceeded. Available as a Mockzilla mock endpoint.
GET /users/{userId}/sessions
users
List user sessions
Get the user sessions list by its unique ID.
POST /users/{userId}/sessions
users
Create session
Creates a session for a user. Returns an immediately usable session object. If you want to generate a token for a custom authentication flow, use the POST /users/{userId}/tokens endpoint.
DEL /users/{userId}/sessions
users
Delete user sessions
Delete all user's sessions by using the user's unique ID.
DEL /users/{userId}/sessions/{sessionId}
users
Delete user session
Delete a user sessions by its unique ID.
PATCH /users/{userId}/status
users
Update user status
Update the user status by its unique ID. Use this endpoint as an alternative to deleting a user if you want to keep user's ID reserved. Mockzilla mock: no signup, no API key.
GET /users/{userId}/targets
users
List User Targets
List the messaging targets that are associated with a user.
POST /users/{userId}/targets
users
Create User Target
Create a messaging target.
GET /users/{userId}/targets/{targetId}
users
Get User Target
Get a user's push notification target by ID.
PATCH /users/{userId}/targets/{targetId}
users
Update User target
Update a messaging target.
DEL /users/{userId}/targets/{targetId}
users
Delete user target
Delete a messaging target. Served by the Mockzilla mock runtime.
POST /users/{userId}/tokens
users
Create token
Returns a token with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the PUT /account/sessions/custom endpoint to complete the login process.
PATCH /users/{userId}/verification
users
Update email verification
Update the user email verification status by its unique ID.
PATCH /users/{userId}/verification/phone
users
Update phone verification
Update the user phone verification status by its unique ID.