curl --request GET \
--url https://api.cekura.ai/test_framework/v1/tools/{id}/ \
--header 'X-CEKURA-API-KEY: <api-key>'import requests
url = "https://api.cekura.ai/test_framework/v1/tools/{id}/"
headers = {"X-CEKURA-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-CEKURA-API-KEY': '<api-key>'}};
fetch('https://api.cekura.ai/test_framework/v1/tools/{id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cekura.ai/test_framework/v1/tools/{id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-CEKURA-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cekura.ai/test_framework/v1/tools/{id}/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-CEKURA-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cekura.ai/test_framework/v1/tools/{id}/")
.header("X-CEKURA-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cekura.ai/test_framework/v1/tools/{id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-CEKURA-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"name": "<string>",
"id": 123,
"description": "<string>",
"information": "<unknown>",
"freetext_params": "<unknown>",
"mock_url": "<string>",
"served_via": "<string>",
"mcp_server": "<string>",
"subscriber_count": "<string>",
"is_shared": true,
"subscribers": [
{}
]
}Get Tool
Return a single mock tool with its input/output pairs and the agents using it.
curl --request GET \
--url https://api.cekura.ai/test_framework/v1/tools/{id}/ \
--header 'X-CEKURA-API-KEY: <api-key>'import requests
url = "https://api.cekura.ai/test_framework/v1/tools/{id}/"
headers = {"X-CEKURA-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-CEKURA-API-KEY': '<api-key>'}};
fetch('https://api.cekura.ai/test_framework/v1/tools/{id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cekura.ai/test_framework/v1/tools/{id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-CEKURA-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cekura.ai/test_framework/v1/tools/{id}/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-CEKURA-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cekura.ai/test_framework/v1/tools/{id}/")
.header("X-CEKURA-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cekura.ai/test_framework/v1/tools/{id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-CEKURA-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"name": "<string>",
"id": 123,
"description": "<string>",
"information": "<unknown>",
"freetext_params": "<unknown>",
"mock_url": "<string>",
"served_via": "<string>",
"mcp_server": "<string>",
"subscriber_count": "<string>",
"is_shared": true,
"subscribers": [
{}
]
}Authorizations
Response
Information of the tool - must be a list of input-output mappings. Each mapping may add
an optional response ({status_code, headers, delay_seconds}) to simulate a failing or slow tool:
status_code 200-299 (except 204 and 205) or 400-599 (default 200), delay_seconds up to 300.
headers apply to webhook-style tools only; MCP and VAPI function calls carry the status in
the tool result instead.
Mappings may also follow the call's progress: state (the call state(s) a mapping answers in,
a name or a list; every call starts in "start") and then (the state the call moves to after the
mapping replies). match "exact" requires every input key to be present and equal (default
"flexible"). Mappings for the call's current state are served before mappings without a state, and
within each, a mapping whose input is identical to the call's arguments comes first. The call is
identified by the X-Cekura-Mock-Session header, or by the provider's call id; without one the
call stays in "start".
Example:
[
{
"input": {"user_id": 1},
"output": {"name": "John Doe", "age": 30, "email": "john@example.com"}
},
{
"input": {"user_id": 2},
"output": {"name": "Jane Smith", "age": 25, "email": "jane@example.com"}
},
{
"input": {"user_id": 3},
"output": {"detail": "Service temporarily unavailable"},
"response": {"status_code": 503, "headers": {"Retry-After": "30"}, "delay_seconds": 2}
},
{
"input": {"user_id": 4},
"state": "start",
"output": {"detail": "busy"},
"response": {"status_code": 503},
"then": "retried"
},
{
"input": {"user_id": 4},
"state": "retried",
"output": {"status": "active"}
}
]