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

GET/api/external/v1/test/async-echo

Simulates 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)query
  • toolTaskIdstringquery
  • secretstringquery
  • callbackUrlstringquery
  • X-Tool-Task-Idstringheader
  • X-Tool-Secretstringheader
  • X-Callback-Urlstringheader

Responses

  • 202Accepted - a callback will be sent after the delay
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found

Asynchronous test echo endpoint

POST/api/external/v1/test/async-echo

Simulates 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)query
  • toolTaskIdstringquery
  • secretstringquery
  • callbackUrlstringquery
  • X-Tool-Task-Idstringheader
  • X-Tool-Secretstringheader
  • X-Callback-Urlstringheader

Responses

  • 202Accepted - a callback will be sent after the delay
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found

Asynchronous test echo endpoint

PUT/api/external/v1/test/async-echo

Simulates 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)query
  • toolTaskIdstringquery
  • secretstringquery
  • callbackUrlstringquery
  • X-Tool-Task-Idstringheader
  • X-Tool-Secretstringheader
  • X-Callback-Urlstringheader

Responses

  • 202Accepted - a callback will be sent after the delay
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found

Asynchronous test echo endpoint

PATCH/api/external/v1/test/async-echo

Simulates 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)query
  • toolTaskIdstringquery
  • secretstringquery
  • callbackUrlstringquery
  • X-Tool-Task-Idstringheader
  • X-Tool-Secretstringheader
  • X-Callback-Urlstringheader

Responses

  • 202Accepted - a callback will be sent after the delay
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found

Asynchronous test echo endpoint

DELETE/api/external/v1/test/async-echo

Simulates 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)query
  • toolTaskIdstringquery
  • secretstringquery
  • callbackUrlstringquery
  • X-Tool-Task-Idstringheader
  • X-Tool-Secretstringheader
  • X-Callback-Urlstringheader

Responses

  • 202Accepted - a callback will be sent after the delay
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found

Synchronous test echo endpoint

GET/api/external/v1/test/sync-echo

A 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 received
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found

Synchronous test echo endpoint

POST/api/external/v1/test/sync-echo

A 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 received
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found

Synchronous test echo endpoint

PUT/api/external/v1/test/sync-echo

A 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 received
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found

Synchronous test echo endpoint

PATCH/api/external/v1/test/sync-echo

A 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 received
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found

Synchronous test echo endpoint

DELETE/api/external/v1/test/sync-echo

A 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 received
  • 401Missing or invalid API key
  • 403Key is valid but lacks access to this resource
  • 404Requested resource not found