User resources
/users
Method: GET
Description: Query all known usernames.
Parameters: none
Request URL
| Code Block | ||
|---|---|---|
| ||
$base_url/api/v0/users |
Example response body
| Code Block | ||
|---|---|---|
| ||
{
"users": [
"alice",
"bob",
"carol"
]
} |
/users/{username}
Method: PUT
Description: Ensures a user with the specified username exists.
Parameters
| Name | Description | Default value |
username(required) | The username for which a user profile should be created if it doesn't exist already. | - |
Example request URL
| Code Block | ||
|---|---|---|
| ||
$base_url/api/v0/users/alice |
Example response body: none (status code 204 indicates success/user already exists)
/users/{username}
Method: DELETE
Description: Deletes the user profile with the specified username if it exists.
Parameters
| Name | Description | Default value |
username(required) | The username for which a user profile should be deleted if it exists. | - |
Example request URL
| Code Block | ||
|---|---|---|
| ||
$base_url/api/v0/users/alice |
Example response body: none (status code 204 indicates success/user not found)
Synchronization resources
/synchronizations
Method: GET
Description: Query all synchronizations.
Parameters: none
Request URL
| Code Block | ||
|---|---|---|
| ||
$base_url/api/v0/synchronizations |
Example response body
| Code Block | ||
|---|---|---|
| ||
{
"synchronizations": [
{
"id": 1,
"username": "alice",
"type": "o365"
},
{
"id": 2,
"username": "bob",
"type": "googlecalendar"
}
]
} |
/synchronizations
Method: PUT
Description: Sets up a synchronization with a user's external calendar.
Parameters
| Name | Description | Default value |
username(required) | The username for which the synchronization should be created. | - |
type(required) | The synchronization type, which indicates the calendaring service provider. | - |
| smtpAddress * | The user's mailbox address in Exchange or Office 365. | - |
* Only applicable when using a ProvisioningPreDelegatedEWSLinkingAdapter or ProvisioningPreAuthorizedOffice365LinkingAdapter.
Example request URL
| Code Block | ||
|---|---|---|
| ||
$base_url/api/v0/synchronizations |
Example request body
| Code Block |
|---|
username=alice&type=ews&smtpAddress=alice@example.org |
Example response body: none (status code 204 indicates success)
/synchronizations/{id}
Method: DELETE
Description: Deletes the synchronization with the specified id.
Parameters
| Name | Description | Default value |
username(required) | The id of the synchronization which should be deleted. | - |
unlinkMode(required) | The unlink mode indicates what should happen to the events in the user's calendar:
| - |
Example request URL
| Code Block | ||
|---|---|---|
| ||
$base_url/api/v0/synchronizations/3 |
Example response body: none (status code 204 indicates success; 422 indicates synchronization not found)