Skip to content

Commit 3175e85

Browse files
authored
Merge pull request #2161 from Veera-mulge/bulk-api-announcement
2 parents 96e97fc + 3e122db commit 3175e85

File tree

3 files changed

+83
-0
lines changed

3 files changed

+83
-0
lines changed
Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
layout: post
3+
title: "Announcing Bulk API: Handle heavy data workloads with ease"
4+
description: Perform multiple database operations in a single API call. Enjoy faster writes and better performance for heavy server-side workloads.
5+
date: 2025-07-03
6+
cover: /images/blog/announcing-bulk-api/cover.png
7+
timeToRead: 5
8+
author: jake-barnby
9+
category: announcement
10+
featured: false
11+
---
12+
13+
We're excited to introduce another Appwrite Databases feature, **Bulk API**. Explicitly designed to handle heavy write workloads, Bulk API dramatically improves performance by allowing multiple database operations in a single API call.
14+
15+
# Faster development with bulk actions
16+
17+
Previously, writing or modifying large amounts of data in Appwrite Databases required sending one request per document. This method was inefficient, slow, and resource-intensive, especially when dealing with thousands of records.
18+
19+
With the new Bulk API, you can create, update, or delete multiple documents in one go, vastly speeding up your workflows and reducing network overhead.
20+
21+
# Optimized for server-side workloads
22+
23+
Bulk API is crafted for server-side applications, particularly those with significant data demands. Whether you’re importing large datasets, performing batch updates, or cleaning out old records, Bulk API streamlines your workload, drastically cutting down the number of requests and enhancing your application's performance.
24+
25+
This will have immediate and impactful benefits such as:
26+
27+
- **Speed improvements**: Rapidly handle thousands of operations simultaneously.
28+
- **Lower network overhead**: Significantly fewer API requests needed, making your application faster and more efficient.
29+
- **Seamless integration**: Works effortlessly using Appwrite Cloud or hosting yourself.
30+
31+
{% info title="Please Note" %}
32+
Bulk operations can only be performed via the server-side SDKs. The client-side SDKs do not support bulk operations.
33+
{% /info %}
34+
35+
# How it works
36+
37+
Utilizing the Bulk API is straightforward. You can use it to:
38+
39+
- Create multiple documents in a single request using the `createDocuments` method
40+
- Update multiple documents in a single request using the `updateDocuments` method
41+
- Delete multiple documents in a single request using the `deleteDocuments` method
42+
- Upsert multiple documents in a single request using the `upsertDocuments` method
43+
44+
Here is a code example for creating multiple documents in a single request:
45+
46+
47+
```server-nodejs
48+
const sdk = require('node-appwrite');
49+
50+
const client = new sdk.Client()
51+
.setEndpoint('https://<REGION>.cloud.appwrite.io/v1')
52+
.setProject('<PROJECT_ID>')
53+
.setKey('<API_KEY>');
54+
55+
const databases = new sdk.Databases(client);
56+
57+
const result = await databases.createDocuments(
58+
'<DATABASE_ID>',
59+
'<COLLECTION_ID>',
60+
[
61+
{
62+
$id: sdk.ID.unique(),
63+
name: 'Document 1',
64+
},
65+
{
66+
$id: sdk.ID.unique(),
67+
name: 'Document 2',
68+
}
69+
]
70+
);
71+
```
72+
73+
74+
# Built for intensive data tasks
75+
76+
Bulk API was designed to move large volumes of data in and out of Appwrite. By simplifying and speeding up these tasks, Bulk API unlocks previously challenging use-cases, expanding what's possible with Appwrite.
77+
78+
With Bulk API, your high-performance data operations are faster, simpler, and more efficient.
79+
80+
# More resources
81+
- [Read the documentation to get started](/docs/products/databases/bulk-operations)
82+
- [Introducing Database Backups](/blog/post/introducing-database-backups)
83+
- [More Database blogs](https://appwrite.io/blog?search=database)
98.4 KB
Loading
98.4 KB
Loading

0 commit comments

Comments
 (0)