Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

User resources

/users

MethodGET

Description: Query all known usernames.

Parameters: none

Request URL

Code Block
languagenone
$base_url/api/v0/users

Example response body

Code Block
languagenone
{
    "users": [
        "alice", 
        "bob", 
        "carol"
    ]
}

/users/{username}

MethodPUT

Description: Ensures a user with the specified username exists.

Parameters

NameDescriptionDefault value
username(required)The username for which a user profile should be created if it doesn't exist already.-

Example request URL

Code Block
languagenone
$base_url/api/v0/users/alice

Example response body: none (status code 204 indicates success/user already exists)

/users/{username}

MethodDELETE

Description: Deletes the user profile with the specified username if it exists.

Parameters

NameDescriptionDefault value
username(required)The username for which a user profile should be deleted if it exists.-

Example request URL

Code Block
languagenone
$base_url/api/v0/users/alice

Example response body: none (status code 204 indicates success/user not found)

Synchronization resources

/synchronizations

MethodGET

Description: Query all synchronizations.

Parameters: none

Request URL

Code Block
languagenone
$base_url/api/v0/synchronizations

Example response body

Code Block
languagenone
{
    "synchronizations": [
        {
            "id": 1,
            "username": "alice",
            "type": "o365"
        },
        {
            "id": 2,
            "username": "bob",
            "type": "googlecalendar"
        }
    ]
}

/synchronizations

MethodPUT

Description: Sets up a synchronization with a user's external calendar.

Parameters

NameDescriptionDefault 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
languagenone
$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}

MethodDELETE

Description: Deletes the synchronization with the specified id.

Parameters

NameDescriptionDefault 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:

  • UNLINK_ONLYLeaves all events in place.
  • DELETE_FUTURE_EVENTSOnly events which have been pushed with this specific synchronization id and which have a start date in the future are removed.
  • DELETE_ALL_EVENTSAll events which have been pushed with this specific synchronization id are removed.
  • CLEANUPAll events which have been pushed by this MyTimetable instance are removed, even those with a different synchronization id.
-

Example request URL

Code Block
languagenone
$base_url/api/v0/synchronizations/3

Example response body: none (status code 204 indicates success; 422 indicates synchronization not found)