Create project

POST /user/v1/projects

cURL

cURL

curl --request POST \
  --url https://api.cekura.ai/user/v1/projects/ \
  --header 'Content-Type: application/json' \
  --header 'X-CEKURA-API-KEY: <api-key>' \
  --data '
{
  "name": "<string>",
  "outbound_timeout": 123,
  "max_call_duration": 123,
  "min_call_duration": 123,
  "sample_rate": 123,
  "max_messages_chat_runs_limit": 123,
  "webhook_url": "<string>",
  "webhook_secret": "<string>",
  "evaluate_relevant_metrics_enabled": true,
  "end_call_enabled": true,
  "generate_scenario_auto_assign_numbers_enabled": true,
  "enable_client_side_testing": true,
  "should_show_powered_by": true,
  "notify_results_completion": true,
  "notify_daily_report": true,
  "notify_daily_report_no_calls": true,
  "notify_cron_failure": true,
  "notify_cron_success": true,
  "notify_no_calls": true,
  "no_calls_notify_time_period": "<unknown>",
  "notify_daily_report_webhook": true,
  "notify_result_webhook_failed": true,
  "notify_result_webhook_success": true,
  "notify_cronjob_webhook_failed": true,
  "notify_cronjob_webhook_success": true,
  "notify_call_log_webhook_failed": true,
  "notify_call_log_webhook_success": true,
  "notify_frequent_calls_for_number": true,
  "frequent_calls_threshold": -1,
  "frequent_calls_time_period": -1,
  "frequent_calls_cooldown": -1,
  "forward_vapi_webhook": true,
  "forward_retell_webhook": true,
  "is_send_emails_enabled": true,
  "rubric_config": "<unknown>",
  "timezone": "<string>",
  "vapi_api_key": "<string>",
  "retell_api_key": "<string>",
  "syntflow_api_key": "<string>",
  "elevenlabs_api_key": "<string>",
  "livekit_api_key": "<string>",
  "pipecat_api_key": "<string>",
  "is_deleted": true
}
'

201

{
  "id": 123,
  "name": "<string>",
  "members": [
    {
      "id": 123,
      "user": {
        "id": 123,
        "name": "<string>",
        "email": "[e-mail]"
      },
      "role": "admin",
      "is_email_notify_enabled": true,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "organization": {
    "id": 123,
    "name": "<string>",
    "members": [
      {
        "id": 123,
        "user": {
          "id": 123,
          "name": "<string>",
          "email": "[e-mail]"
        },
        "role": "admin",
        "is_email_notify_enabled": true,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "outbound_timeout": 123,
  "max_call_duration": 123,
  "min_call_duration": 123,
  "sample_rate": 123,
  "max_messages_chat_runs_limit": 123,
  "webhook_url": "<string>",
  "webhook_secret": "<string>",
  "evaluate_relevant_metrics_enabled": true,
  "end_call_enabled": true,
  "generate_scenario_auto_assign_numbers_enabled": true,
  "enable_client_side_testing": true,
  "should_show_powered_by": true,
  "notify_results_completion": true,
  "notify_daily_report": true,
  "notify_daily_report_no_calls": true,
  "notify_cron_failure": true,
  "notify_cron_success": true,
  "notify_no_calls": true,
  "no_calls_notify_time_period": "<unknown>",
  "notify_daily_report_webhook": true,
  "notify_result_webhook_failed": true,
  "notify_result_webhook_success": true,
  "notify_cronjob_webhook_failed": true,
  "notify_cronjob_webhook_success": true,
  "notify_call_log_webhook_failed": true,
  "notify_call_log_webhook_success": true,
  "notify_frequent_calls_for_number": true,
  "frequent_calls_threshold": -1,
  "frequent_calls_time_period": -1,
  "frequent_calls_cooldown": -1,
  "forward_vapi_webhook": true,
  "forward_retell_webhook": true,
  "is_send_emails_enabled": true,
  "rubric_config": "<unknown>",
  "timezone": "<string>",
  "vapi_api_key": "<string>",
  "retell_api_key": "<string>",
  "syntflow_api_key": "<string>",
  "elevenlabs_api_key": "<string>",
  "livekit_api_key": "<string>",
  "pipecat_api_key": "<string>",
  "is_deleted": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

X-CEKURA-API-KEY · string · header · required

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

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

name · string

Name of the project Example: "Default Project"

outbound_timeout · integer

Outbound timeout in seconds Example: 300

max_call_duration · integer

Max call duration in seconds Example: 300

min_call_duration · integer

Min call duration in seconds Example: 30

sample_rate · number<double>

Metric sampling rate (0.0 to 1.0). Default is 1.0 (100% of calls). Example: 0.5 (50%), 0.1 (10%), 0.001 (0.1%)

max_messages_chat_runs_limit · integer

Max messages chat runs limit Example: 100

webhook_url · string<uri>

Webhook URL Example: "https://yourdomain.com/webhook"

webhook_secret · string

Webhook secret Example: "your-webhook-secret"

evaluate_relevant_metrics_enabled · boolean

Evaluate relevant metrics enabled Example: true or false

end_call_enabled · boolean

End call enabled Example: true or false

generate_scenario_auto_assign_numbers_enabled · boolean

Generate scenario auto assign numbers enabled Example: true or false

enable_client_side_testing · boolean

Enable client side testing Example: true or false

should_show_powered_by · boolean

Should show powered by Example: true or false

notify_results_completion · boolean

Notify on result completion Example: true or false

notify_daily_report · boolean

Notify daily report Example: true or false

notify_daily_report_no_calls · boolean

Notify daily report even if there are no calls Example: true or false

notify_cron_failure · boolean

Notify cron failure Example: true or false

notify_cron_success · boolean

Notify cron success Example: true or false

notify_no_calls · boolean

Notify no calls Example: true or false

no_calls_notify_time_period · any

Configuration for no calls notification time periods, timeframes, exception numbers, and agents to exclude Example:

{
    "time_zone": "America/New_York",
    "time_periods": [
        {
            "start_time": "09:00",
            "end_time": "17:00",
            "time_frame": 30
        },
        {
            "start_time": "18:00",
            "end_time": "23:59",
            "time_frame": 60
        }
    ],
    "exception_numbers": ["[phone]", "[phone]"],
    "agents": [1, 10, 90]
}

Note:

• Calls with customer_number in exception_numbers list will be ignored when checking for no calls alert.
• If agents list is provided and not empty, those specific agents will be excluded from monitoring. All other agents in the project will be monitored. If omitted or empty, all agents in the project will be monitored.

notify_daily_report_webhook · boolean

Notify daily report webhook Example: true or false

notify_result_webhook_failed · boolean

Notify result webhook failed Example: true or false

notify_result_webhook_success · boolean

Notify result webhook success Example: true or false

notify_cronjob_webhook_failed · boolean

Notify cronjob webhook failed Example: true or false

notify_cronjob_webhook_success · boolean

Notify cronjob webhook success Example: true or false

notify_call_log_webhook_failed · boolean

Notify call log webhook failed Example: true or false

notify_call_log_webhook_success · boolean

Notify call log webhook success Example: true or false

notify_frequent_calls_for_number · boolean

frequent_calls_threshold · integer

Required range: -2147483648 <= x <= 2147483647

frequent_calls_time_period · integer

Required range: -2147483648 <= x <= 2147483647

frequent_calls_cooldown · integer

Required range: -2147483648 <= x <= 2147483647

forward_vapi_webhook · boolean

Forward vapi webhook Example: true or false

forward_retell_webhook · boolean

Forward retell webhook Example: true or false

is_send_emails_enabled · boolean

Is send emails enabled Example: true or false

rubric_config · any | null

Project-level scoring rubric configuration for call success evaluation

timezone · string

Project Timezone

vapi_api_key · string

VAPI API key Example: "vapi_api_key_123"

retell_api_key · string

Retell API key Example: "retell_api_key_123"

syntflow_api_key · string

Syntflow API key Example: "syntflow_api_key_123"

elevenlabs_api_key · string

ElevenLabs API key Example: "elevenlabs_api_key_123"

livekit_api_key · string

LiveKit API key Example: "livekit_api_key_123"

pipecat_api_key · string

Pipecat/Daily.co API key Example: "pipecat_api_key_123"

is_deleted · boolean

Response

201 - application/json

id · integer

name · string

Name of the project Example: "Default Project"

members · object[]

Show child attributes

organization · object

Show child attributes

outbound_timeout · integer

Outbound timeout in seconds Example: 300

max_call_duration · integer

Max call duration in seconds Example: 300

min_call_duration · integer

Min call duration in seconds Example: 30

sample_rate · number<double>

Metric sampling rate (0.0 to 1.0). Default is 1.0 (100% of calls). Example: 0.5 (50%), 0.1 (10%), 0.001 (0.1%)

max_messages_chat_runs_limit · integer

Max messages chat runs limit Example: 100

webhook_url · string<uri>

Webhook URL Example: "https://yourdomain.com/webhook"

webhook_secret · string

Webhook secret Example: "your-webhook-secret"

evaluate_relevant_metrics_enabled · boolean

Evaluate relevant metrics enabled Example: true or false

end_call_enabled · boolean

End call enabled Example: true or false

generate_scenario_auto_assign_numbers_enabled · boolean

Generate scenario auto assign numbers enabled Example: true or false

enable_client_side_testing · boolean

Enable client side testing Example: true or false

should_show_powered_by · boolean

Should show powered by Example: true or false

notify_results_completion · boolean

Notify on result completion Example: true or false

notify_daily_report · boolean

Notify daily report Example: true or false

notify_daily_report_no_calls · boolean

Notify daily report even if there are no calls Example: true or false

notify_cron_failure · boolean

Notify cron failure Example: true or false

notify_cron_success · boolean

Notify cron success Example: true or false

notify_no_calls · boolean

Notify no calls Example: true or false

no_calls_notify_time_period · any

Configuration for no calls notification time periods, timeframes, exception numbers, and agents to exclude Example:

{
    "time_zone": "America/New_York",
    "time_periods": [
        {
            "start_time": "09:00",
            "end_time": "17:00",
            "time_frame": 30
        },
        {
            "start_time": "18:00",
            "end_time": "23:59",
            "time_frame": 60
        }
    ],
    "exception_numbers": ["[phone]", "[phone]"],
    "agents": [1, 10, 90]
}

Note:

• Calls with customer_number in exception_numbers list will be ignored when checking for no calls alert.
• If agents list is provided and not empty, those specific agents will be excluded from monitoring. All other agents in the project will be monitored. If omitted or empty, all agents in the project will be monitored.

notify_daily_report_webhook · boolean

Notify daily report webhook Example: true or false

notify_result_webhook_failed · boolean

Notify result webhook failed Example: true or false

notify_result_webhook_success · boolean

Notify result webhook success Example: true or false

notify_cronjob_webhook_failed · boolean

Notify cronjob webhook failed Example: true or false

notify_cronjob_webhook_success · boolean

Notify cronjob webhook success Example: true or false

notify_call_log_webhook_failed · boolean

Notify call log webhook failed Example: true or false

notify_call_log_webhook_success · boolean

Notify call log webhook success Example: true or false

notify_frequent_calls_for_number · boolean

frequent_calls_threshold · integer

Required range: -2147483648 <= x <= 2147483647

frequent_calls_time_period · integer

Required range: -2147483648 <= x <= 2147483647

frequent_calls_cooldown · integer

Required range: -2147483648 <= x <= 2147483647

forward_vapi_webhook · boolean

Forward vapi webhook Example: true or false

forward_retell_webhook · boolean

Forward retell webhook Example: true or false

is_send_emails_enabled · boolean

Is send emails enabled Example: true or false

rubric_config · any | null

Project-level scoring rubric configuration for call success evaluation

timezone · string

Project Timezone

vapi_api_key · string

VAPI API key Example: "vapi_api_key_123"

retell_api_key · string

Retell API key Example: "retell_api_key_123"

syntflow_api_key · string

Syntflow API key Example: "syntflow_api_key_123"

elevenlabs_api_key · string

ElevenLabs API key Example: "elevenlabs_api_key_123"

livekit_api_key · string

LiveKit API key Example: "livekit_api_key_123"

pipecat_api_key · string

Pipecat/Daily.co API key Example: "pipecat_api_key_123"

is_deleted · boolean

created_at · string<date-time>

updated_at · string<date-time>