appwrite-dotnet

Install the Appwrite NuGet package with dotnet add package Appwrite, then create a Client configured with SetEndpoint, SetProject, and SetKey using your project ID and API key. From there you instantiate services like Users, TablesDB, or Storage.

Use an admin client with an API key to call account.CreateEmailPasswordSession, then store the session secret in an HttpOnly, Secure, SameSite=Strict cookie named a_session_<PROJECT_ID>. Create a per-request session client with SetSession for authenticated calls.

Use TablesDB for all new code because the Databases class is deprecated. TablesDB provides CreateRow, ListRows, GetRow, UpdateRow, and DeleteRow methods and supports explicit string column types like varchar, text, mediumtext, and longtext.

Appwrite grants no access by default, so rows created without explicit permissions are inaccessible to everyone including the creator. Pass Permission and Role strings such as Permission.Read(Role.User(userId)) when creating rows or configure table-level permissions.

Use the Storage service's CreateFile method with a bucket ID, unique file ID, and an InputFile built via FromPath, FromBytes, or FromStream. You can attach permission strings in the same call to control read, update, and delete access.

Catch AppwriteException, which exposes Message, HTTP status Code, error Type such as document_not_found, and the full Response body. Common codes include 401 for invalid credentials, 403 for insufficient permissions, and 429 for rate limiting.