@forge/teamwork-graph 3.1.0-next.3-experimental-f76634b → 3.1.0-next.4

package/README.md

@@ -49,7 +49,10 @@ const document: DocumentObject = {
   }
 };
 
-const result = await graph.setObjects({ objects: [document] });
+const result = await graph.setObjects({ 
+  objects: [document],
+  connectionId: 'data-source:connection-123'
+});
 
 if (result.success) {
   console.log('Document created successfully:', result.results);
@@ -103,13 +106,15 @@ const document: DocumentObject = {
 };
 
 const bulkResult = await graph.setObjects({
-  objects: [document]
+  objects: [document],
+  connectionId: 'data-source:connection-123'
 });
 
 // Get object by external ID
 const objectResult = await graph.getObjectByExternalId({
   objectType: 'atlassian:document',
-  externalId: 'doc-123'
+  externalId: 'doc-123',
+  connectionId: 'data-source:connection-123'
 });
 
 if (objectResult.success) {
@@ -121,13 +126,18 @@ if (objectResult.success) {
 // Delete objects by external IDs
 const deleteResult = await graph.deleteObjectsByExternalId({
   objectType: 'atlassian:document',
-  externalIds: ['doc-123', 'doc-456']
+  externalIds: ['doc-123', 'doc-456'],
+  connectionId: 'data-source:connection-123'
 });
 
 // Delete objects by properties
 const deleteByPropsResult = await graph.deleteObjectsByProperties({
-  environment: 'staging',
-  status: 'completed'
+  objectType: 'atlassian:document',
+  properties: {
+    environment: 'staging',
+    status: 'completed'
+  },
+  connectionId: 'data-source:connection-123'
 });
 ```
 
@@ -147,17 +157,20 @@ const usersResult = await graph.setUsers({
       ],
       updateSequenceNumber: 1
     }
-  ]
+  ],
+  connectionId: 'data-source:connection-123'
 });
 
 // Get user by external ID
 const userResult = await graph.getUserByExternalId({
-  externalId: 'user-123'
+  externalId: 'user-123',
+  connectionId: 'data-source:connection-123'
 });
 
 // Delete users by external IDs
 const deleteUsersResult = await graph.deleteUsersByExternalId({
-  externalIds: ['user-123', 'user-456']
+  externalIds: ['user-123', 'user-456'],
+  connectionId: 'data-source:connection-123'
 });
 
 // Map users to Atlassian accounts
@@ -169,7 +182,8 @@ const mapResult = await graph.mapUsers({
       updatedAt: Date.now(),
       accountId: 'acc-123'
     }
-  ]
+  ],
+  connectionId: 'data-source:connection-123'
 });
 ```
 
@@ -186,17 +200,20 @@ const groupsResult = await graph.setGroups({
       displayName: 'Developers',
       description: 'Development team'
     }
-  ]
+  ],
+  connectionId: 'data-source:connection-123'
 });
 
 // Get group by external ID
 const groupResult = await graph.getGroupByExternalId({
-  externalId: 'group-123'
+  externalId: 'group-123',
+  connectionId: 'data-source:connection-123'
 });
 
 // Delete groups by external IDs
 const deleteGroupsResult = await graph.deleteGroupsByExternalId({
-  externalIds: ['group-123', 'group-456']
+  externalIds: ['group-123', 'group-456'],
+  connectionId: 'data-source:connection-123'
 });
 ```
 
@@ -299,7 +316,10 @@ The SDK uses specific error classes for different types of failures:
 // The SDK handles errors internally and returns them in the response
 // You can access error information through the response object:
 
-const result = await graph.setObjects({ objects: [] });
+const result = await graph.setObjects({ 
+  objects: [],
+  connectionId: 'data-source:connection-123'
+});
 
 if (!result.success) {
   console.error('Operation failed:', result.error);
@@ -317,7 +337,8 @@ if (!result.success) {
 // Handle object operations
 const result = await graph.getObjectByExternalId({
   objectType: 'atlassian:document',
-  externalId: 'nonexistent'
+  externalId: 'nonexistent',
+  connectionId: 'data-source:connection-123'
 });
 
 if (!result.success) {
@@ -331,7 +352,8 @@ if (result.originalError) {
 
 // Handle validation errors (these are returned in the response)
 const result = await graph.setObjects({
-  objects: [] // Empty array will return error in response
+  objects: [], // Empty array will return error in response
+  connectionId: 'data-source:connection-123'
 });
 
 if (!result.success) {