Create Task
Create the task with the createTask endpoint, or use our Software Development Kit to make your integration process even easier!Task Structure
| Property | Type | Required |
|---|---|---|
type | String | Yes |
url | String | Yes |
script_url | String | No |
script_content | String | Yes |
Example Request
Example Response
taskId- Unique identifier for this task. Use this to retrieve results.
Getting Results
Retrieve the results using the getTaskResult method. or use our Software Development Kit to make your integration process even easier!Example Request
Example Response
x-kpsdk-*- Header values that need to be sent to the /tl endpoint.payload- Payload to post to /tl which will give you the validated data.user-agent- User-Agent that was used to make this payload.
Quick Start Example
We have examples for all our tasks to streamline integration. Feel free to check them out!Payload Examples
All our Kasada Payload Examples can be found here!
Common Troubleshooting
Because we rely on the data you provide, small discrepancies, such as mismatched user-agents, can occasionally cause issues.Not getting a 200 and "reload": true from /tl?
If the /tl endpoint does not return a 200 response with "reload": true, the request has failed. Please verify the following:
- The correct
user-agentis being used. - The same
user-agentis sent with every request, not just the POST. - All required headers are included in the POST request to
/tl. - The request body is decoded before being sent.
Receiving a token but still getting blocked?
There are a variety of reasons this can happen, but let’s start with the most common. Please verify the following:- You are proxying all requests, preferably with a sticky session.
- You are using a well-crafted TLS client.
- You are not posting the
kpsdk-vvalue to the protected endpoint.