Subscribe to Webhook[beta]

Create Subscription
This method is used to subscribe to the the async api task status webhook. This subscription enables users to get the status of the DAG run as soon as it completes its execution. This API can be used to attach the endpointUrl to the webhook so that the completion notification gets pushed to this endpointUrl 
Request body
Key
Value
userId
Id of the user under which the subscription should be created
event
Type of event the subscription should be made
endpointUrl
Url to which the webhook notification should be pushed to
1
curl --location --request POST 'https://api.marsview.ai/cb/v1/profile/webhooks/create_webhook_subscription/<USERID>' \
2
--header 'Content-Type: application/json' \
3
--header "Authorization:{{Insert Auth Token With Type}}" \
4
--data-raw '{
5
	"userId":<USERID>,
6
	"event":"process.completion",
7
	"endpointUrl":<ENDPOINT URL>
8
}'
Copied!
Response
1
{
2
    "status": true,
3
    "data": {
4
        "subscriptionId": "webhook-1c6q67jckywkiwtu-1643263273650"
5
    }
6
}
Copied!
Response Object
​
Key
Description
subscriptionId
Subscription ID generated for the consumer subscribing to the webhook
Sample Webhook Notification
1
{
2
"txnId":"txn-xxxxxx-xxxxxx-xxxxx",
3
"status":{id:2, state:'processed'}
4
}
Copied!
Get Subscription
This method is used to get either the entire list of subscriptions of a user or the details of a specific subscription. Both of these details can be fetched using the following API's
​
​
Request for getting all subscriptions
​
1
curl --location --request GET 'https://api.marsview.ai/cb/v1/profile/webhooks/get_user_webhook_subscription/<USERID>' \
2
--header 'Content-Type: application/json' \
3
--header "Authorization:{{Insert Auth Token With Type}}" 
Copied!
Sample Response
1
{
2
    "status": true,
3
    "data": [
4
        {
5
            "_id": "61f235293923b02628e0d6bd",
6
            "event": "process.completion",
7
            "userId": "[email protected]",
8
            "endpointUrl": "https://ee24-111-111-111-193.ngrok.io/webhook",
9
            "subscriptionId": "webhook-1c6q67jckywkiwtu-1643263273650",
10
        },
11
        {
12
            "_id": "6123cvew23402628e0d6bd",
13
            "event": "process.completion",
14
            "userId": "[email protected]",
15
            "endpointUrl": "https://ee24-111-111-98-193.ngrok.io/webhook",
16
            "subscriptionId": "webhook-1c6q67asdqdwrcsa-1643263273650",
17
        }
18
    ]
19
}
Copied!
Request for getting specific subscription
1
curl --location --request GET 'https://api.marsview.ai/cb/v1/profile/webhooks/get_webhook_subscription/<USERID>/<SUBSCRIPTION ID>' \
2
--header 'Content-Type: application/json' \
3
--header "Authorization:{{Insert Auth Token With Type}}" 
Copied!
Sample Response
1
{
2
    "status": true,
3
    "data": {
4
            "_id": "61f235293923b02628e0d6bd",
5
            "event": "process.completion",
6
            "userId": "[email protected]",
7
            "endpointUrl": "<ENDPOINT URL>",
8
            "subscriptionId": "webhook-1c6q67jckywkiwtu-1643263273650",
9
        }
10
}
Copied!
Response Object
Key
Description
event
Type of process event
userId
Id of the user under which the subscription is created
subscriptionId
Id of the subscription
endpointUrl
Url to which the webhook notification is pushed
Delete Webhook
The Delete Webhook API can be used to terminate existing subscriptions
Sample request
1
curl --location --request DELETE 'https://api.marsview.ai/cb/v1/profile/webhooks/delete_webhook_subscription/<USERID>/<SUBSCRIPTION ID>' \
2
--header 'Content-Type: application/json' \
3
--header "Authorization:{{Insert Auth Token With Type}}" 
Copied!
Sample response
1
{
2
    "status": true,
3
    "data": {
4
        "msg": "webhook Deleted successfully",
5
        "subscriptionId": "webhook-1c6q67jckywkiwtu-1643263273650"
6
    }
7
}
Copied!
Response Object
Key
Value
msg
Message indicating the status of deletion
subscriptionId
Id of the subscription that has been deleted