Bulk operations (experimental)

With bulk operations, you can now add multiple, different types of items to a board in a single call. You can add up to 20 items of the same or different type per create call. For example, you can create 3 shape items, 4 card items, and 5 sticky notes in one create call.

The bulk create operation is transactional. If any item's create operation fails, the create operation for all the remaining items also fails, and none of the items will be created.

Creating items in bulk results in:

  • Better user experience: You no longer need to think about how to use concurrency for your programming language when you create multiple items at once. 

  • Transactionality: When you need to create multiple dependent items, creating items in bulk allows you to ensure that either all of them are created or none of them are created in case of an error. This saves your time and effort for cleaning up in case anything does not go as planned. 

  • Performance: Replacing multiple requests with one request saves your resources as you need only one physical connection instead of multiple connections. Additionally, the time it takes to create multiple items is lower than the time it takes to create items one-by-one due to the reduced number of roundtrips over the wire.

Rate limiting

Level 2 per item. For example, if you want to create one sticky note, one card, and one shape item in one call, the rate limiting applicable will be 300 credits. This is because create item calls take Level 2 rate limiting of 100 credits each, 100 for sticky note, 100 for card, and 100 for shape item.

Supported items

The experimental release supports the following items:

  • App card
  • Text
  • Shape
  • Sticky note
  • Image item using URL and image item using file from device
  • Document item using URL and document item using file from device
  • Card
  • Frame
  • Embed