Agendize Watchers API

Watchers API Reference

The Watchers API empowers you to watch your client interactions.


Resource representation

{ "id": {string}, "address": {string}, "name": {string}, "basicAuth": { "username": {string}, "password": {string} }, "httpRequestHeader": { (name): {string} }, "objectOwner": { "type": {string}, "id": {boolean} }, "schema": {object}, "addPreviousData": {boolean}, "levelDetails": {string}, "method": {string}, "status": {string}, "oauth2Auth": { "clientId": {string}, "clientSecret": {string}, "refreshToken": {string},, "authUrl": {string}, "accessTokenUrl": {string}, "redirectUri": {string} }, "signature": { "enabled": {boolean}, "keys": [ {string} ] } }
Parameter name Value Description
address string The address where notifications are delivered for this watch.
Optional Properties
name string Name of the watch.
basicAuth string Credentials parameters for HTTP Basic authentication on the destination watch address. Only if you use this authentication method.
basicAuth.username string Username.
basicAuth.password string Password.
httpRequestHeader string Custom header parameters to send with the http request on the destination watch address.
httpRequestHeader.name string header parameter name.
schema object Custom json schema to apply for resource properties.
addPreviousData boolean Add data of the previous version of the resource.
levelDetails string level json details for the resource. Values: "full" or "extraFull". Default value is "full".
method string HTTP Method to use for sending content. DELETE Method doesn't accept body content.
status string Status of the watcher. Values: "enabled", "disabled"
oauth2Auth string Credentials parameters for HTTP OAuth2 authentication on the destination watch address. Only if you use this authentication method.
oauth2Auth.clientId string OAuth2 client id.
oauth2Auth.refreshToken string OAuth2 refresh token.
oauth2Auth.authUrl string OAuth2 interactive end point to initiate the generation of the refresh token.
oauth2Auth.accessTokenUrl string OAuth2 end point to generation an access token from the refresh token.
oauth2Auth.scope string OAuth2 api scope.
signature object Produces a crypto signature of the watched content.
signature.enabled boolean Sets if the signature is enabled or not.
signature.cryptoKeyIds list List of crypto key identifier.

Delete

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

DELETE https://api.agendize.com/api/2.0/watchers/{watcherId}

Parameters

Parameter name Value Description
Path parameters
watcherId string Watcher identifier.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns an empty response body.


Get

Returns an entry of the watcher list.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET https://api.agendize.com/api/2.0/watchers/{watcherId}

Parameters

Parameter name Value Description
Path parameters
watcherId string Watcher identifier.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a Watcher resource in the response body.


List

Returns entries on the watcher list.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET https://api.agendize.com/api/2.0/watchers

Parameters

Parameter name Value Description
Optional query parameters
objectType datetime Type of the watchers's objects. Values: 'schedulingCompany', 'callTracking', 'clickToCall'.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{ items: [Watcher Resource] }