Appwrite Regions API
Appwrite Cloud regions available to a project, and the regional endpoints they resolve to. 6 operations across 6 paths in the Appwrite 2.0.0 OpenAPI.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/appwrite-regions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.0.0
info:
title: Appwrite Regions API
description: Appwrite backend as a service cuts up to 70% of the time and costs required for building a modern application. We abstract and simplify common development tasks behind a REST APIs, to help you develop your app in a fast and secure way. For full API documentation and tutorials go to [https://appwrite.io/docs](https://appwrite.io/docs)
version: 2.0.0
termsOfService: https://appwrite.io/policy/terms
contact:
name: Appwrite Team
url: https://appwrite.io/support
email: team@appwrite.io
license:
name: BSD-3-Clause
url: https://raw.githubusercontent.com/appwrite/appwrite/master/LICENSE
servers:
- url: https://cloud.appwrite.io/v1
description: Appwrite Cloud endpoint.
- url: https://{region}.cloud.appwrite.io/v1
description: Appwrite Cloud regional endpoint. Replace `{region}` with your project region.
variables:
region:
default: fra
description: Appwrite Cloud region.
tags:
- name: regions
description: Appwrite regions service.
paths:
/regions/cache:
delete:
summary: Purge platform manager cache resource from network regions
operationId: regionsDeleteCache
tags:
- regions
description: Purges platform manager cache resource from network regions.
responses:
'204':
description: No content
deprecated: false
x-appwrite:
group: null
demo: regions/delete-cache.md
rate-limit: 0
rate-time: 3600
rate-key: url:{url},ip:{ip}
scope: public
platforms:
- manager
packaging: false
public: true
auth:
manager: []
security:
- Project: []
parameters:
- name: documentId
description: Document ID.
required: false
schema:
type: string
example: <DOCUMENT_ID>
default: ''
in: query
- name: collectionId
description: CollectionID.
required: false
schema:
type: string
example: <COLLECTION_ID>
default: ''
in: query
- name: region
description: Project Region.
required: false
schema:
type: string
example: fra
title: Region
oneOf:
- type: string
enum:
- fra
title: fra
- type: string
enum:
- nyc
title: nyc
- type: string
enum:
- syd
title: syd
- type: string
enum:
- sfo
title: sfo
- type: string
enum:
- sgp
title: sgp
- type: string
enum:
- tor
title: tor
in: query
- name: cache
description: Cache target.
required: false
schema:
type: string
example: cache
title: CacheTarget
oneOf:
- type: string
enum:
- cache
title: cache
- type: string
enum:
- timelimit
title: timelimit
- type: string
enum:
- locks
title: locks
- type: string
enum:
- pubsub
title: pubsub
- type: string
enum:
- queue
title: queue
- type: string
enum:
- all
title: all
default: cache
in: query
- name: all
description: Clear the entire selected cache target.
required: false
schema:
type: boolean
example: false
default: false
in: query
- name: database
description: Database cache scope.
required: false
schema:
type: string
example: console
title: CacheDatabase
oneOf:
- type: string
enum:
- console
title: console
- type: string
enum:
- project
title: project
- type: string
enum:
- logs
title: logs
default: console
in: query
- name: projectId
description: Project ID for project or logs database cache.
required: false
schema:
type: string
example: <PROJECT_ID>
default: ''
in: query
- name: json
description: Return JSON instead of 204.
required: false
schema:
type: boolean
example: false
default: false
in: query
/regions/deployments/{deploymentId}/runtime:
get:
summary: Get the runtime information by deployment ID
operationId: regionsGetDeploymentRuntime
tags:
- regions
description: Retrieves runtime information for a deployment by deployment ID.
responses:
'200':
description: Runtime
content:
application/json:
schema:
$ref: '#/components/schemas/managerRuntime'
deprecated: false
x-appwrite:
group: null
demo: regions/get-deployment-runtime.md
rate-limit: 0
rate-time: 3600
rate-key: url:{url},ip:{ip}
scope: ''
platforms:
- manager
packaging: false
public: true
parameters:
- name: projectId
description: Project ID
required: false
schema:
type: string
example: <PROJECT_ID>
default: ''
in: query
- name: deploymentId
description: Deployment ID
required: true
schema:
type: string
example: <DEPLOYMENT_ID>
in: path
/regions/events:
post:
summary: Queue an event in the given region
operationId: regionsCreateEvent
tags:
- regions
description: Queues an event in the given region using CloudEvents specification.
responses:
'204':
description: No content
deprecated: false
x-appwrite:
group: null
demo: regions/create-event.md
rate-limit: 0
rate-time: 3600
rate-key: url:{url},ip:{ip}
scope: ''
platforms:
- manager
packaging: false
public: true
requestBody:
content:
application/json:
schema:
type: object
properties:
specversion:
description: CloudEvents spec version
type: string
default: '1.0'
example: <SPECVERSION>
type:
description: Event type that maps to worker. e.g. v1-stats-usage
type: string
example: <TYPE>
source:
description: Event source. e.g. imagine
type: string
default: ''
example: <SOURCE>
subject:
description: Subject of the event, i.e. projectId
type: string
example: <SUBJECT>
id:
description: Unique event ID
type: string
default: ''
example: <ID>
time:
description: Event timestamp in RFC3339 format
type: string
default: ''
example: <TIME>
datacontenttype:
description: Content type of data
type: string
default: application/json
example: <DATACONTENTTYPE>
data:
description: 'Event data containing metrics. e.g. {"metrics": [...]}'
type: object
default: {}
example: {}
required:
- type
- subject
- data
/regions/events/execution:
post:
summary: Create a new execution for a function or site
operationId: regionsCreateExecution
tags:
- regions
description: Creates a new execution record for a function or site.
responses:
'204':
description: No content
deprecated: false
x-appwrite:
group: null
demo: regions/create-execution.md
rate-limit: 0
rate-time: 3600
rate-key: url:{url},ip:{ip}
scope: ''
platforms:
- manager
packaging: false
public: true
requestBody:
content:
application/json:
schema:
type: object
properties:
projectId:
description: Project ID
type: string
default: ''
example: <PROJECT_ID>
deploymentId:
description: Deployment ID
type: string
example: <DEPLOYMENT_ID>
responseStatusCode:
description: Response status code
type: integer
example: 100
format: int32
responseHeaders:
description: Response headers
type: object
default: {}
example: {}
responseSize:
description: Response size in bytes
type: integer
format: int32
requestPath:
description: Request path
type: string
example: <REQUEST_PATH>
requestMethod:
description: Request method
type: string
example: get
title: RequestMethod
oneOf:
- type: string
enum:
- get
title: get
- type: string
enum:
- post
title: post
- type: string
enum:
- put
title: put
- type: string
enum:
- patch
title: patch
- type: string
enum:
- delete
title: delete
- type: string
enum:
- options
title: options
- type: string
enum:
- head
title: head
requestHeaders:
description: Request headers
type: object
default: {}
example: {}
requestSize:
description: Request size in bytes
type: integer
format: int32
errors:
description: Errors
type: string
example: <ERRORS>
logs:
description: Logs
type: string
example: <LOGS>
duration:
description: Execution duration in seconds
type: number
format: float
hostname:
description: Request hostname (edge-only)
type: string
default: ''
example: <HOSTNAME>
userAgent:
description: Request user-agent (edge-only)
type: string
default: ''
example: <USER_AGENT>
country:
description: ISO 3166-1 alpha-2 country (edge-only)
type: string
default: ''
example: <COUNTRY>
ip:
description: Request client IP (edge-only)
type: string
default: ''
example: <IP>
service:
description: Service name (edge-only)
type: string
default: ''
example: <SERVICE>
required:
- deploymentId
- responseStatusCode
- responseHeaders
- responseSize
- requestPath
- requestMethod
- requestHeaders
- requestSize
- errors
- logs
- duration
/regions/project:
delete:
summary: Delete project from network regions
operationId: regionsDeleteProject
tags:
- regions
description: Deletes a project from network regions.
responses:
'204':
description: No content
deprecated: false
x-appwrite:
group: null
demo: regions/delete-project.md
rate-limit: 0
rate-time: 3600
rate-key: url:{url},ip:{ip}
scope: public
platforms:
- manager
packaging: false
public: true
auth:
manager: []
security:
- Project: []
parameters:
- name: projectId
description: Project ID.
required: true
schema:
type: string
example: <PROJECT_ID>
in: query
/regions/usage:
post:
summary: Push usage stats to stats usage queue
operationId: regionsCreateUsage
tags:
- regions
description: Pushes usage statistics to the stats usage queue.
responses:
'204':
description: No content
deprecated: false
x-appwrite:
group: null
demo: regions/create-usage.md
rate-limit: 0
rate-time: 3600
rate-key: url:{url},ip:{ip}
scope: public
platforms:
- manager
packaging: false
public: true
auth:
manager: []
security:
- Project: []
requestBody:
content:
application/json:
schema:
type: object
properties:
usage:
description: 'Usage stats as a JSON string. Array of entries with projectId, metrics, and timestamp. eg: [{"projectId": "123", "metrics": [{"key": "requests", "value": 1}], "timestamp": "2021-01-01 00:00:00"}]'
type: string
example: <USAGE>
required:
- usage
components:
schemas:
managerRuntime:
description: Runtime
type: object
properties:
deploymentId:
type: string
description: Deployment ID of function
example: fid8jx6ws45jana098ab7
variables:
type: object
additionalProperties: true
description: Environment variables for the function execution
example:
API_KEY: your-api-key
DEBUG: 'true'
headers:
type: object
additionalProperties: true
description: Headers for the function execution
example:
X-Appwrite-Key: your-api-key
DEBUG: 'true'
scopes:
type: array
description: Scopes for the dyanmic key passed in function execution
items:
type: string
example:
- users.read
- users.write
nullable: true
execute:
type: array
description: Allowed groups for the function execution
items:
type: string
example:
- any
- guest
nullable: true
timeout:
type: integer
description: Function timeout in seconds.
format: int32
example: 0
source:
type: string
description: Build source path
example: ''
entrypoint:
type: string
description: Build entrypoint file
example: ''
version:
type: string
description: Function version.
example: v4
cpus:
type: number
description: Function CPU count.
format: double
example: 0.5
memory:
type: integer
description: Function memory limit in MB.
format: int32
example: 512
logging:
type: boolean
description: Function logging.
example: true
image:
type: string
description: Runtime image name.
example: ''
command:
type: string
description: Function runtime command.
example: nohup helpers/start.sh "node index.js"
tags:
type: object
description: Edge cache invalidation tags derived from the runtime.
allOf:
- $ref: '#/components/schemas/managerTags'
nullable: true
required:
- deploymentId
- timeout
- source
- entrypoint
- version
- cpus
- memory
- logging
- image
- command
example:
deploymentId: fid8jx6ws45jana098ab7
variables: '{"API_KEY":"your-api-key","DEBUG":"true"}'
headers: '{"X-Appwrite-Key":"your-api-key","DEBUG":"true"}'
scopes: '["users.read","users.write"]'
execute: '["any","guest"]'
timeout: 0
source: ''
entrypoint: ''
version: v4
cpus: 0.5
memory: 512
logging: true
image: ''
command: nohup helpers/start.sh "node index.js"
tags: ''
managerTags:
description: Tags
type: object
properties:
project:
type: string
description: Project cache tag.
example: 5e5ea5c16897e
nullable: true
team:
type: string
description: Team cache tag.
example: 5e5ea5c16897f
nullable: true
deployment:
type: string
description: Deployment cache tag.
example: 5e5ea5c168981
nullable: true
domain:
type: string
description: Domain cache tag.
example: function.example.com
nullable: true
resource:
type: string
description: Resource type cache tag.
example: function
nullable: true
function:
type: string
description: Function cache tag.
example: 5e5ea5c168980
nullable: true
site:
type: string
description: Site cache tag.
example: 5e5ea5c168980
nullable: true
example:
project: 5e5ea5c16897e
team: 5e5ea5c16897f
deployment: 5e5ea5c168981
domain: function.example.com
resource: function
function: 5e5ea5c168980
site: 5e5ea5c168980
securitySchemes:
Project:
type: apiKey
name: X-Appwrite-Project
description: Your project ID
in: header
x-appwrite:
platforms:
- client
- server
- console
demo: <YOUR_PROJECT_ID>
externalDocs:
description: Full API docs, specs and tutorials
url: https://appwrite.io/docs