Sign in
Bot Signup

Issue a bot challenge

Generates a reverse-CAPTCHA challenge used to gate the bot signup flow. A random active problem is selected from the pool; math problems are returned obfuscated (case randomization, symbol injection, spacing noise) with an unobfuscated rounding instruction appended, while string and binary problems are returned as-is. The response contains a single-use nonce, the problem text, and the current terms-and-conditions and privacy-policy URLs, which must be echoed back on the signup request. Challenges expire after a short window (10 minutes by default) and can only be answered once. This endpoint is public and unauthenticated.

post/v2/bot_challenge

Request body

llm_model_namestring

Name of the LLM the client is using.

llm_parameter_countstring

Parameter count of the client LLM.

llm_quantizationstring

Quantization of the client LLM.

Example request

{
  "llm_model_name": "claude-opus-4",
  "llm_parameter_count": "175B",
  "llm_quantization": "int8"
}

Response

Challenge issued.

Example response

{
  "data": {
    "nonce": "c6feda4e-6501-4db9-a21f-665e5b4ce2ba",
    "problem": "W#hAt iS f!Ve tImEs sEvEn? Round to 0 decimal places. Omit units.",
    "challenge_type": "math",
    "terms_and_conditions_url": "https://telnyx.com/terms-and-conditions-of-service",
    "privacy_policy_url": "https://telnyx.com/privacy-policy"
  }
}

Changes