Introduction

The Workspace 365 Provisioning API is intended for provisioning and managing Workspace 365 resources. The API uses a REST-ish interface meaning instead of calling Actions/Methods, you define the Action you want to perform on a resource via the HTTP METHOD (i.e. GET, POST, PUT & DELETE) and uses JSON as its data protocol.

Prerequisites

• The API needs to be enabled in Workspace 365.
• In order to access the Provisioning API, a so called Provisioning Key needs to be provided with each request. The Provisioning Key is provided via the value of a header called “ProvisioningKey”.
• An extra header is provided with every request (X-Requested-With: XMLHttpRequest).

If you are hosting Workspace 365, see section “Configuration for Hosters”.

API

The Provisioning API is located at “/Provisioning” (e.g. when Workspace 365 is hosted on https://portal.workspace365.net, the Provisioning API is located at https://workspaceinstanceurl/Provisioning).

Below, we describe the available endpoints and their data objects per resource type. Included in each endpoint is an example of the request. These examples assume Workspace 365 has the following settings:

• Workspace 365 is hosted on https://portal.workspace365.net
• The Provisioning Key is C7656554-85A2-4AFD-BAB7-18C71593C4D2