Appwrite Elixir SDK

Elixir client SDK for Appwrite — the open-source backend-as-a-service platform. Covers all client-facing APIs: Auth · Databases · TablesDB · Storage · Functions · Sites · Tokens · Teams · Messaging · GraphQL · Locale · Avatars · Health.

Installation

Add appwrite to your dependencies in mix.exs:

def deps do
  [
    {:appwrite, "~> 1.0"}
  ]
end

Then fetch:

mix deps.get

Configuration

`config/config.exs`

config :appwrite,
  project_id: System.get_env("APPWRITE_PROJECT_ID"),
  secret:     System.get_env("APPWRITE_SECRET"),
  root_uri:   System.get_env("APPWRITE_ENDPOINT", "https://cloud.appwrite.io/v1")

`config/runtime.exs` (recommended for production)

import Config

if config_env() == :prod do
  config :appwrite,
    project_id: System.fetch_env!("APPWRITE_PROJECT_ID"),
    secret:     System.fetch_env!("APPWRITE_SECRET"),
    root_uri:   System.get_env("APPWRITE_ENDPOINT", "https://cloud.appwrite.io/v1")
end

Self-hosted Appwrite? Set APPWRITE_ENDPOINT to your instance URL, e.g. https://appwrite.mycompany.com/v1.

Quick start

alias Appwrite.Services.{Accounts, Database, Storage}
alias Appwrite.Utils.{Id, Query, Permission, Role}

# Create a new user
{:ok, _user} = Accounts.create(Id.unique(), "alice@example.com", "secret123")

# Email + password login
{:ok, _session} = Accounts.create_email_password_session("alice@example.com", "secret123")

# Query documents
{:ok, result} = Database.list_documents("my-db", "posts", [
  Query.equal("published", true),
  Query.order_desc("created_at"),
  Query.limit(10)
])

# Upload a file
file_content = File.read!("report.pdf")
{:ok, file} = Storage.create_file("my-bucket", Id.unique(), %{
  "name" => "report.pdf",
  "data" => file_content,
  "type" => "application/pdf",
  "size" => byte_size(file_content)
})

# Get a download URL (unauthenticated via token)
{:ok, token} = Appwrite.Services.Tokens.create_file_token("my-bucket", file["$id"])
{:ok, url} = Storage.get_file_download("my-bucket", file["$id"], token["secret"])

Services

Module	Appwrite API
`Appwrite.Services.Accounts`	Auth, sessions, MFA, OAuth2, recovery
`Appwrite.Services.Avatars`	Avatars, flags, QR codes, screenshots
`Appwrite.Services.Database`	Documents, upsert, increment/decrement, transactions
`Appwrite.Services.Functions`	Executions (create, get, list)
`Appwrite.Services.GraphQL`	GraphQL query and mutation
`Appwrite.Services.Health`	Server health checks
`Appwrite.Services.Locale`	Countries, currencies, languages
`Appwrite.Services.Messaging`	Push/SMS/email topic subscribers
`Appwrite.Services.Sites`	Hosted site deployments and variables
`Appwrite.Services.Storage`	Files, chunked upload, preview/view/download URLs
`Appwrite.Services.TablesDB`	Tables, columns, rows
`Appwrite.Services.Teams`	Teams and memberships
`Appwrite.Services.Tokens`	File access tokens

Utilities

Module	Purpose
`Appwrite.Utils.Query`	Build filter/sort/pagination query strings
`Appwrite.Utils.Permission`	Generate `read()`, `write()`, `create()` … strings
`Appwrite.Utils.Role`	Generate `any`, `user:id`, `team:id/role` … strings
`Appwrite.Utils.Id`	`Id.unique()` / `Id.custom("my-id")`

Permission + Role example

alias Appwrite.Utils.{Permission, Role}

permissions = [
  Permission.read(Role.any()),               # public read
  Permission.create(Role.users()),           # any logged-in user can create
  Permission.update(Role.user("alice-id")),  # only alice can update
  Permission.delete(Role.team("admins"))     # admins can delete
]

Error handling

All service functions return {:ok, map()} or {:error, reason}. API errors are Appwrite.Exceptions.AppwriteException structs:

alias Appwrite.Exceptions.AppwriteException

case Accounts.get() do
  {:ok, user} ->
    IO.puts("Hello, #{user["name"]}")

  {:error, %AppwriteException{code: 401}} ->
    IO.puts("Not authenticated")

  {:error, %AppwriteException{code: code, message: msg}} ->
    IO.puts("Appwrite error #{code}: #{msg}")

  {:error, reason} ->
    IO.inspect(reason, label: "Unexpected error")
end

Requirements

Elixir ~> 1.18
Erlang/OTP 26+

License

Apache 2.0 — see LICENSE.