Docs
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

When disabled, executions will exclude logs and errors, and will be slightly faster.

string

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

string

Build Commands.

enum

List of scopes allowed for API key auto-generated for every execution. Maximum of 200 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.

array

List of branch name patterns to trigger automatic deployments. Supports wildcards. Leave empty to deploy on all branches.

array

List of file path patterns to trigger automatic deployments. Supports wildcards. Leave empty to deploy on all file changes.

string

Build specification for the function deployments.

string

Runtime specification for the function executions.

integer

Days to keep non-active deployments before deletion. Value 0 means all deployments will be kept.

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

When disabled, executions will exclude logs and errors, and will be slightly faster.

string

Function execution and build runtime.

integer

How many days to keep the non-active deployments before they will be automatically deleted.

string

Function's active deployment ID.

string

Active deployment creation date in ISO 8601 format.

string

Function's latest deployment ID.

string

Latest deployment creation date in ISO 8601 format.

string

Status of latest deployment. Possible values are "waiting", "processing", "building", "ready", and "failed".

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

arrayof string

List of branch name patterns that trigger automatic deployments. Supports glob wildcards. Empty list deploys on all branches.

arrayof string

List of file path patterns that trigger automatic deployments. Supports glob wildcards. Empty list deploys on all file changes.

string

Machine specification for deployment builds.

string

Machine specification for executions.

Dart
import 'package:dart_appwrite/dart_appwrite.dart';
import 'package:dart_appwrite/enums.dart' as enums;


Client client = Client()
    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
    .setProject('<YOUR_PROJECT_ID>') // Your project ID
    .setKey('<YOUR_API_KEY>'); // Your secret API key


Functions functions = Functions(client);


Func result = await functions.create(
    functionId: '<FUNCTION_ID>',
    name: '<NAME>',
    runtime: enums.Runtime.node145,
    execute: ["any"], // (optional)
    events: [], // (optional)
    schedule: '', // (optional)
    timeout: 1, // (optional)
    enabled: false, // (optional)
    logging: false, // (optional)
    entrypoint: '<ENTRYPOINT>', // (optional)
    commands: '<COMMANDS>', // (optional)
    scopes: [enums.ProjectKeyScopes.projectRead], // (optional)
    installationId: '<INSTALLATION_ID>', // (optional)
    providerRepositoryId: '<PROVIDER_REPOSITORY_ID>', // (optional)
    providerBranch: '<PROVIDER_BRANCH>', // (optional)
    providerSilentMode: false, // (optional)
    providerRootDirectory: '<PROVIDER_ROOT_DIRECTORY>', // (optional)
    providerBranches: [], // (optional)
    providerPaths: [], // (optional)
    buildSpecification: '', // (optional)
    runtimeSpecification: '', // (optional)
    deploymentRetention: 0, // (optional)
);