Actions44
- User Actions
- Database Actions
- Collection Actions
- Document Actions
- Index Actions
- Function Actions
- Storage Actions
Overview
This node integrates with the Appwrite API to manage databases. Specifically, the Update Database operation allows users to modify an existing database's properties, such as its name, by specifying the unique database ID and the new values.
Common scenarios where this node is beneficial include:
- Renaming a database to better reflect its contents or purpose.
- Updating metadata of a database after creation without needing to recreate it.
- Automating database management workflows within n8n when working with Appwrite backend services.
For example, you might use this node in a workflow that updates the database name based on user input or external triggers, ensuring your database names stay consistent and meaningful.
Properties
| Name | Meaning |
|---|---|
| Database ID | The unique identifier of the database to update. Use "unique()" to auto-generate for creation (not applicable here). |
| Name | The new name to assign to the database. |
Output
The output JSON contains the updated database object returned from the Appwrite API after a successful update operation. This typically includes fields such as the database ID, updated name, creation date, and other metadata managed by Appwrite.
If the update operation fails, the node throws an error with details about the failure.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Appwrite API via an API key credential configured in n8n.
- The node uses the Appwrite client library internally to communicate with the Appwrite backend.
- Proper permissions are required on the Appwrite side to update databases.
Troubleshooting
Common issues:
- Invalid or missing
Database ID: Ensure the correct database ID is provided; otherwise, the update will fail. - Insufficient permissions: The API key used must have rights to update databases.
- Network or authentication errors: Verify API credentials and network connectivity.
- Invalid or missing
Error messages:
- Errors from the Appwrite API are propagated and wrapped in a structured error object.
- If the node encounters an unknown error, it returns a generic message "An unknown error occurred."
- To resolve errors, check the error message details and ensure all required parameters and credentials are correctly set.