Skip to main content
PATCH
cURL

Authorizations

X-CEKURA-API-KEY
string
header
required

API Key Authentication. It should be included in the header of each request.

Path Parameters

id
integer
required

A unique integer value identifying this ai agent test profile.

Body

agent
integer | null

ID of the agent. Either agent or project must be provided.

project
integer | null

ID of the project. Either agent or project must be provided.

name
string

Name of the test profile

information
object

Test profile information. Use the sectioned shape — main_agent_variables (sent to the agent under test as dynamic variables at call time) and testing_agent_variables (persona/context used by the simulated caller, not sent to the agent). Legacy flat dicts (no section keys) are still accepted and delivered to both sides for backward compatibility. Example: {"main_agent_variables": {"user_id": "U-42"}, "testing_agent_variables": {"customer_name": "John Doe"}}.

Response

200 - application/json
name
string
required
Maximum string length: 255
id
integer
read-only
project
integer | null
agent
integer | null
agent_name
string
read-only

Name of the agent associated with this test profile Example: "Customer Support Agent"

information
any

Variables for the test profile, split by which agent receives them.

main_agent_variables are sent to the agent under test as dynamic variables. testing_agent_variables shape the simulated caller's persona. A legacy flat dict (no section keys) is accepted for backward compatibility and is sent to both agents.

Keys in main_agent_variables starting with X- are additionally sent as custom SIP headers (SIP runs) or connection headers (WebSocket runs) to the agent under test. For SIP runs this is the only way to pass custom headers; X-Run-Id, X-Scenario-Id, and X-Result-Id are reserved and always set by Cekura.

created_by
integer
read-only

ID of the user who created this test profile

last_updated_by
integer
read-only

ID of the user who last updated this test profile

created_at
string<date-time>
read-only

Timestamp when the test profile was created

updated_at
string<date-time>
read-only

Timestamp when the test profile was last updated