Docs : SDK : putTransaction

putTransaction lets you submit multiple database operations as a single atomic batch. Either all operations succeed, or the entire batch fails. You will never see partial updates. This API will return a promise that gets resolved once the transaction has been fully applied and durably persisted to the database.

    
    userbase.putTransaction({
      databaseName: 'example-database-name',
      operations: [
        { command: 'Insert', item: { example: 'Sample Item A' } },
        { command: 'Update', item: { example: 'Sample Item B' }, itemId: '0002' },
        { command: 'Delete', itemId: '0003' }
      ]
    }).then(() => {
      // transaction applied
    }).catch((e) => console.error(e))
    
  

Parameters

• databaseName [string | Len: 1-100] - The database name to use.
• operations [Array | Len: 1-10] - The insert, update, or delete operations to execute as an atomic transaction. There is a limit of 10 operations per transaction.

Advanced Parameters

• shareToken [string | optional] - The token used to access a shared database.
• databaseId [string | optional] - The database's unique identifier.

Errors

• ParamsMustBeObject
• DatabaseNotOpen
• DatabaseNameMissing
• DatabaseNameMustBeString
• DatabaseNameCannotBeBlank
• DatabaseNameTooLong
• DatabaseNameRestricted
• DatabaseIdMustBeString
• DatabaseIdCannotBeBlank
• DatabaseIdInvalidLength
• DatabaseIdNotAllowed
• DatabaseIsReadOnly
• OperationsMissing
• OperationsMustBeArray
• OperationsConflict
• OperationsExceedLimit
• CommandNotRecognized
• ItemIdMissing
• ItemIdMustBeString
• ItemIdCannotBeBlank
• ItemIdTooLong
• ItemMissing
• ItemInvalid
• ItemTooLarge
• ItemAlreadyExists
• ItemDoesNotExist
• ItemUpdateConflict
• TransactionUnauthorized
• UserNotSignedIn
• UserNotFound
• TooManyRequests
• ServiceUnavailable