API reference
Test Endpoints
10 endpoints. Add your API key in the authentication panel to send test requests from this page.
Asynchronous test echo endpoint
/api/external/v1/test/async-echoSimulates a real downstream async API, for testing a tool's API Call step with "Asynchronous Request" enabled end-to-end. Immediately acknowledges the request, then - after delaySeconds (default 10, max 120) - POSTs a test result back to the callback URL, using whatever toolTaskId/secret it received (query params, X-Tool-Task-Id / X-Tool-Secret headers, or JSON body fields - whichever your step sends). If no callbackUrl was included in the request, falls back to Kilevel's own async-tool-task webhook endpoint.
Parameters
delaySecondsinteger (int32)querytoolTaskIdstringquerysecretstringquerycallbackUrlstringqueryX-Tool-Task-IdstringheaderX-Tool-SecretstringheaderX-Callback-Urlstringheader
Responses
202Accepted - a callback will be sent after the delay401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found
Asynchronous test echo endpoint
/api/external/v1/test/async-echoSimulates a real downstream async API, for testing a tool's API Call step with "Asynchronous Request" enabled end-to-end. Immediately acknowledges the request, then - after delaySeconds (default 10, max 120) - POSTs a test result back to the callback URL, using whatever toolTaskId/secret it received (query params, X-Tool-Task-Id / X-Tool-Secret headers, or JSON body fields - whichever your step sends). If no callbackUrl was included in the request, falls back to Kilevel's own async-tool-task webhook endpoint.
Parameters
delaySecondsinteger (int32)querytoolTaskIdstringquerysecretstringquerycallbackUrlstringqueryX-Tool-Task-IdstringheaderX-Tool-SecretstringheaderX-Callback-Urlstringheader
Responses
202Accepted - a callback will be sent after the delay401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found
Asynchronous test echo endpoint
/api/external/v1/test/async-echoSimulates a real downstream async API, for testing a tool's API Call step with "Asynchronous Request" enabled end-to-end. Immediately acknowledges the request, then - after delaySeconds (default 10, max 120) - POSTs a test result back to the callback URL, using whatever toolTaskId/secret it received (query params, X-Tool-Task-Id / X-Tool-Secret headers, or JSON body fields - whichever your step sends). If no callbackUrl was included in the request, falls back to Kilevel's own async-tool-task webhook endpoint.
Parameters
delaySecondsinteger (int32)querytoolTaskIdstringquerysecretstringquerycallbackUrlstringqueryX-Tool-Task-IdstringheaderX-Tool-SecretstringheaderX-Callback-Urlstringheader
Responses
202Accepted - a callback will be sent after the delay401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found
Asynchronous test echo endpoint
/api/external/v1/test/async-echoSimulates a real downstream async API, for testing a tool's API Call step with "Asynchronous Request" enabled end-to-end. Immediately acknowledges the request, then - after delaySeconds (default 10, max 120) - POSTs a test result back to the callback URL, using whatever toolTaskId/secret it received (query params, X-Tool-Task-Id / X-Tool-Secret headers, or JSON body fields - whichever your step sends). If no callbackUrl was included in the request, falls back to Kilevel's own async-tool-task webhook endpoint.
Parameters
delaySecondsinteger (int32)querytoolTaskIdstringquerysecretstringquerycallbackUrlstringqueryX-Tool-Task-IdstringheaderX-Tool-SecretstringheaderX-Callback-Urlstringheader
Responses
202Accepted - a callback will be sent after the delay401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found
Asynchronous test echo endpoint
/api/external/v1/test/async-echoSimulates a real downstream async API, for testing a tool's API Call step with "Asynchronous Request" enabled end-to-end. Immediately acknowledges the request, then - after delaySeconds (default 10, max 120) - POSTs a test result back to the callback URL, using whatever toolTaskId/secret it received (query params, X-Tool-Task-Id / X-Tool-Secret headers, or JSON body fields - whichever your step sends). If no callbackUrl was included in the request, falls back to Kilevel's own async-tool-task webhook endpoint.
Parameters
delaySecondsinteger (int32)querytoolTaskIdstringquerysecretstringquerycallbackUrlstringqueryX-Tool-Task-IdstringheaderX-Tool-SecretstringheaderX-Callback-Urlstringheader
Responses
202Accepted - a callback will be sent after the delay401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found
Synchronous test echo endpoint
/api/external/v1/test/sync-echoA standing test target for a tool's synchronous API Call step. Responds immediately, echoing back the method, headers, query parameters, and body it received - useful for confirming that template placeholders (e.g. {{args.value}}) are resolving the way you expect before pointing the step at a real downstream API.
Responses
200Echoes back what was received401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found
Synchronous test echo endpoint
/api/external/v1/test/sync-echoA standing test target for a tool's synchronous API Call step. Responds immediately, echoing back the method, headers, query parameters, and body it received - useful for confirming that template placeholders (e.g. {{args.value}}) are resolving the way you expect before pointing the step at a real downstream API.
Responses
200Echoes back what was received401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found
Synchronous test echo endpoint
/api/external/v1/test/sync-echoA standing test target for a tool's synchronous API Call step. Responds immediately, echoing back the method, headers, query parameters, and body it received - useful for confirming that template placeholders (e.g. {{args.value}}) are resolving the way you expect before pointing the step at a real downstream API.
Responses
200Echoes back what was received401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found
Synchronous test echo endpoint
/api/external/v1/test/sync-echoA standing test target for a tool's synchronous API Call step. Responds immediately, echoing back the method, headers, query parameters, and body it received - useful for confirming that template placeholders (e.g. {{args.value}}) are resolving the way you expect before pointing the step at a real downstream API.
Responses
200Echoes back what was received401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found
Synchronous test echo endpoint
/api/external/v1/test/sync-echoA standing test target for a tool's synchronous API Call step. Responds immediately, echoing back the method, headers, query parameters, and body it received - useful for confirming that template placeholders (e.g. {{args.value}}) are resolving the way you expect before pointing the step at a real downstream API.
Responses
200Echoes back what was received401Missing or invalid API key403Key is valid but lacks access to this resource404Requested resource not found