Skip to main content
POST
/
test_framework
/
v1
/
test-profiles
cURL
curl --request POST \
  --url https://api.cekura.ai/test_framework/v1/test-profiles/ \
  --header 'Content-Type: application/json' \
  --header 'X-CEKURA-API-KEY: <api-key>' \
  --data '
{
  "name": "<string>",
  "agent": 123,
  "project": 123,
  "information": {}
}
'
{
  "id": 123,
  "project": 456,
  "agent": null,
  "name": "<string>",
  "information": {
    "user_name": "John Doe",
    "user_email": "john.doe@example.com"
  }
}

Authorizations

​
X-CEKURA-API-KEY
string
header
required

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

Body

​
name
string
required

Name of the test profile

​
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.

​
information
object

Information fields of the test profile

Response

​
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": {"user_id": "U-123"},
    "testing_agent_variables": {"user_name": "John Doe", "user_email": "john.doe@example.com"}
}

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.

​
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