Hosting swagger file in OneDrive or SharePoint Online

Topic

If your Swagger descriptor file exposes the MS Graph API that requires OAuth, you can host the Swagger descriptor file in an O365 location that uses the same authentication.

Instructions

• You can host your Swagger file in OneDrive and then use the following Graph API URL in Descriptor Location for Rest Service Instance in K2:
  https://graph.microsoft.com/v1.0/me/drive/root:/Swagger/TestSwagger.json:/Content
  In this example, the Swagger file named TestSwagger.json is uploaded to the OneDrive folder called Swagger.
• You can also host the Swagger file in SharePoint Online and then use the following Graph API URL in Descriptor Location:
  https://graph.microsoft.com/v1.0/sites/TESTK2CLOUD.sharepoint.com:/sites/AAA/Test:/lists/Documents/items/1/driveitem/content
  In this example, the swagger file is uploaded to the SharePoint Online Document Library, named Documents in SharePoint Online site AAA/Test, with item ID 1.

Additional Information

• Microsoft Graph: Download the contents of a DriveItem
• Nintex Community: K2 REST Service Broker 403 Forbidden error