Target Types: Destinations

Listing Available Destinations

Use this endpoint to list all available destinations:

curl -X GET \
 https://YOUR_STACK.datatap.adverity.com/api/target-types/ \
 -H 'Authorization: Token TOKEN_VALUE' \

Result (cropped for one type of destination, Google Sheets):

{
 "count": 1,
 "next": null,
 "previous": null,
 "results": [
 {

 "id": 456,
 "name": "Google Sheets",
 "slug": "google-sheets",
 "url": "https://YOUR_STACK.datatap.adverity.com/api/target-types/456/",
 "targets": "https://YOUR_STACK.datatap.adverity.com/api/target-types/456/targets/"
}
]
 } 

Create a New Destination

To create a destination, first perform an OPTIONS call to list all available elements, then perform a POST request accordingly (see Example below). 

Depending on the destination type, different elements will be required. It might make sense to initially look at all available options within the UI for the destination chosen.

Example: Create a Google Sheets Destination

1. Use the GET request below to find out the ID of the Google Sheets destination.

curl -X GET \
 https://YOUR_STACK.datatap.adverity.com/api/target-types/ \
 -H 'Authorization: Token TOKEN_VALUE' \

2. Then, perform an OPTIONS call for the ID e.g. 456 to find out all relevant elements. 

curl -X OPTIONS \
 https://YOUR_STACK.datatap.adverity.com/api/target-types/456/targets/ \
 -H 'Authorization: Token TOKEN_VALUE' \

3. Finally, make a POST request with at least the following elements in the body.

curl -X POST \
 https://YOUR_STACK.datatap.adverity.com/api/target-types/456/targets/ \
 -H 'Authorization: Token TOKEN_VALUE' \ 
 -H 'Content-Type: application/json' \
 -d '{
 "name":"DESTINATION_NAME",
 "auth": "CONNECTION_ID",
 "stack":"ORGANIZATION_ID"
}'

Deleting a Destination

1. To delete an existing destination, first perform a GET request of all existing destinations of a certain type, e.g 456.

curl -X GET \
 https://YOUR_STACK.datatap.adverity.com/api/target-types/456/targets/ \
 -H 'Authorization: Token TOKEN_VALUE' \

2. Use the ID of the relevant destination e.g. 1 and perform a DELETE request.

curl -X DELETE \
 https://YOUR_STACK.datatap.adverity.com/api/target-types/456/targets/1/ \
 -H 'Authorization: Token TOKEN_VALUE' \