Appwrite 2.0 on Product Hunt_

Skip to content
post

Create function

Endpoint

posthttps://<REGION>.cloud.appwrite.io/v1/functions

Description

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.

Required scopes

functions.write

Authentication

Initialize the Appwrite client with setProject() and a server API key (setKey()). For direct REST calls, send X-Appwrite-Project and X-Appwrite-Key.

Parameters

string
Required

Function ID. Choose a custom ID or generate a random ID with ID.unique(). Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.

string
Required

Function name. Max length: 128 chars.

enum
Required

Execution runtime.

array

An array of role strings with execution permissions. By default no user is granted with any execute permissions. learn more about roles. Maximum of 100 roles are allowed, each 64 characters long.

array

Events list. Maximum of 100 events are allowed.

string

Schedule CRON syntax.

integer

Function maximum execution time in seconds.

boolean

Is function enabled? When set to 'disabled', users cannot access the function but Server SDKs with and API key can still access the function. No data is lost when this is toggled.

boolean

Whether executions will be logged. When set to false, executions will not be logged, but will reduce resource used by your Appwrite project.

string

Entrypoint File. This path is relative to the "providerRootDirectory".

string

Build Commands.

array

List of scopes allowed for API key auto-generated for every execution. Maximum of 100 scopes are allowed.

string

Appwrite Installation ID for VCS (Version Control System) deployment.

string

Repository ID of the repo linked to the function.

string

Production branch for the repo linked to the function.

boolean

Is the VCS (Version Control System) connection in silent mode for the repo linked to the function? In silent mode, comments will not be made on commits and pull requests.

string

Path to function code in the linked repo.

string

Repository name of the template.

string

The name of the owner of the template.

string

Path to function code in the template repo.

string

Version (tag) for the repo linked to the function template.

string

Runtime specification for the function and builds.

Status
Content type
201
application/json

Function

Name
Type
Description
string

Function ID.

string

Function creation date in ISO 8601 format.

string

Function update date in ISO 8601 format.

arrayof string

Execution permissions.

string

Function name.

boolean

Function enabled.

boolean

Is the function deployed with the latest configuration? This is set to false if you've changed an environment variables, entrypoint, commands, or other settings that needs redeploy to be applied. When the value is false, redeploy the function to update it with the latest configuration.

boolean

Whether executions will be logged. When set to false, executions will not be logged, but will reduce resource used by your Appwrite project.

string

Function execution runtime.

string

Function's active deployment ID.

arrayof string

Allowed permission scopes.

arrayof Variable

Function variables.

Object type

arrayof string

Function trigger events.

string

Function execution schedule in CRON format.

integer

Function execution timeout in seconds.

string

The entrypoint file used to execute the deployment.

string

The build command used to build the deployment.

string

Version of Open Runtimes used for the function.

string

Function VCS (Version Control System) installation id.

string

VCS (Version Control System) Repository ID

string

VCS (Version Control System) branch name

string

Path to function in VCS (Version Control System) repository

boolean

Is VCS (Version Control System) connection is in silent mode? When in silence mode, no comments will be posted on the repository pull or merge requests

string

Machine specification for builds and executions.

HTTP
POST /v1/functions HTTP/1.1
Host: cloud.appwrite.io
Content-Type: application/json
X-Appwrite-Response-Format: 1.6.0
X-Appwrite-Project: <YOUR_PROJECT_ID>
X-Appwrite-Key: <YOUR_API_KEY>


{
  "functionId": "<FUNCTION_ID>",
  "name": "<NAME>",
  "runtime": "node-14.5",
  "execute": ["any"],
  "events": [],
  "schedule": ,
  "timeout": 1,
  "enabled": false,
  "logging": false,
  "entrypoint": "<ENTRYPOINT>",
  "commands": "<COMMANDS>",
  "scopes": [],
  "installationId": "<INSTALLATION_ID>",
  "providerRepositoryId": "<PROVIDER_REPOSITORY_ID>",
  "providerBranch": "<PROVIDER_BRANCH>",
  "providerSilentMode": false,
  "providerRootDirectory": "<PROVIDER_ROOT_DIRECTORY>",
  "templateRepository": "<TEMPLATE_REPOSITORY>",
  "templateOwner": "<TEMPLATE_OWNER>",
  "templateRootDirectory": "<TEMPLATE_ROOT_DIRECTORY>",
  "templateVersion": "<TEMPLATE_VERSION>",
  "specification": 
}