Tensorlake Documentation

You can use webhooks to get notified about the status of your workflow runs. Webhooks are configured on a per-project basis. The project associated with the API key that is being used to configure the webhook is the one for which the webhook will be triggered. Our webhooks events are managed by Svix, please note none of your data is sent to Svix, only event statuses.

Create and Configure Your Webhook

To use Webhooks with Tensorlake, make sure you have created a project on Tensorlake Cloud.

It is important to disable CSRF protection for the endpoint if the framework you use enables them by default.

Create a webhook

Go to the project that you want to create the webhook for, and click into the Webhooks tab.

Only admins for a project can create webhooks. However, members of a project can view webhooks.

Set up your webhook

Give the webhook a name, and provide a URL that you control.

Configure access for your webhook

Configure your webhook by selecting the event types that you want to listen to — for example, when a workflow invocation starts, when it fails, and when it completes.

Understand the Webhook Payload

When all functions of an application finish running for a given input, Tensorlake sends the following payload to your configured webhook URL:

{
    "workflow_name": "workflow_XXXX",
    "invocation_id": "invocation_XXXX",
    "fn_status": {
        "fn_A": "success",
        "fn_B": "failure"
    }
}

Possible statuses for each function:

success — The function finished running successfully.
failure — The function failed to finish running.

Test Your Webhooks in Tensorlake Cloud

We have a UI to test webhooks. After creating a webhook, select on the event type you want to test.

Secure your Endpoints with Signature Verification

Without signature verification, anyone could send forged requests to your endpoint. Each webhook endpoint has a unique secret to verify the authenticity of incoming requests.

To get your webhook secret:

Navigate to your project’s Webhooks tab in Tensorlake Cloud
Click on your webhook to view its details
Copy the webhook secret displayed in the interface

You can use the Svix libraries to handle secret verification automatically in your application code. Alternatively, you can manually verify the signature using the secret. The verification process involves:

Extracting the signature from the svix-signature header
Computing the expected signature using your webhook secret
Comparing the computed signature with the received signature

For more details and other verification methods, refer to the following resources:

​Create and Configure Your Webhook

​Understand the Webhook Payload

​Test Your Webhooks in Tensorlake Cloud

​Secure your Endpoints with Signature Verification

Create and Configure Your Webhook

Understand the Webhook Payload

Test Your Webhooks in Tensorlake Cloud

Secure your Endpoints with Signature Verification