---
title: "Create a test profile"
method: POST
path: "/test_framework/v1/test-profiles/"
tags: ["test_framework"]
---

# Create a test profile

`POST /test_framework/v1/test-profiles/`

## Request

- Base URL: `https://api.cekura.ai`
- URL: `https://api.cekura.ai/test_framework/v1/test-profiles/`
- Auth: one of:
  - API key in header `X-CEKURA-API-KEY`
  - HTTP bearer
  - HTTP bearer

Create a test profile

## Request body

- SchemaPostAIAgentTestProfileExternal
  - `agent` integer, nullable: ID of the agent. Either agent or project must be provided.
  - `project` integer, nullable: ID of the project. Either agent or project must be provided.
  - `name` string, required: 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`

- AIAgentTestProfile
  - `id` integer
  - `project` integer, nullable
  - `agent` integer, nullable
  - `agent_name` string: Name of the agent associated with this test profile Example: `"Customer Support Agent"`
  - `name` string, required
  - `information` unknown
  - `created_by` integer, nullable: ID of the user who created this test profile
  - `last_updated_by` integer, nullable: ID of the user who last updated this test profile
  - `created_at` string, date-time: Timestamp when the test profile was created
  - `updated_at` string, date-time: Timestamp when the test profile was last updated

## Other responses

- `400`

## Changes

- **2026-11-03** `a6fb6a739212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cekura/apis/cekura-api/changes/test_framework/v1/test-profiles/post.md)

---

[API](https://skmtc.dev/cekura/apis/cekura-api.md) - [All operations](https://skmtc.dev/cekura/apis/cekura-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cekura/apis/cekura-api/revisions/a6fb6a739212?raw)