Create Task

Create a new captcha solving task.

Tip: Need help finding CAPTCHA parameters like websiteKey and pageAction? Check our guide: How to Identify CAPTCHA Parameters Using CapSolver Extension

POST/createTask

Request Body

Parameter	Type	Required	Description
`clientKey`	string	Yes	Your API key
`task`	object	Yes	Task configuration object
`forwardRequest`	object	No	Forward solved token to your endpoint (see below)

Task Object

ReCaptchaV3TaskProxyless

Parameter	Type	Required	Description
`type`	string	Yes	`ReCaptchaV3TaskProxyless`
`websiteURL`	string	Yes	Target website URL
`websiteKey`	string	Yes	reCAPTCHA site key
`pageAction`	string	No	Action name (default: "verify")
`minScore`	number	No	Minimum score 0.1-0.9 (default: 0.7)

ReCaptchaV3EnterpriseTaskProxyless

Same parameters as above, but for Enterprise reCAPTCHA.

Request Forwarding (Optional)

Automatically forward the solved token to your target endpoint. The worker will make the HTTP request with your token injected and return the response.

Credit Policy: When using forwardRequest, credits are only deducted if the forward request returns a 2xx response. Failed forwards don't consume credits, and you still receive the solved token.

forwardRequest Object

Parameter	Type	Required	Description
`url`	string	Yes	Target URL. Use `{{token}}` placeholder for token injection
`method`	string	No	HTTP method: GET, POST, PUT, PATCH, DELETE (default: POST)
`headers`	object	No	HTTP headers as key-value pairs
`body`	string	No	Request body. Use `{{token}}` placeholder for token injection
`timeout`	number	No	Request timeout in seconds, 1-60 (default: 60)

Example Request

Basic (solve only)

terminal

curl -X POST https://api.regotcha.com/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "ReCaptchaV3TaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-",
      "pageAction": "login",
      "minScore": 0.7
    }
  }'

With Request Forwarding

terminal

curl -X POST https://api.regotcha.com/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "ReCaptchaV3TaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-",
      "pageAction": "login"
    },
    "forwardRequest": {
      "url": "https://example.com/api/login",
      "method": "POST",
      "headers": {
        "Content-Type": "application/json",
        "Authorization": "Bearer your-auth-token"
      },
      "body": "{\"username\":\"user\",\"password\":\"pass\",\"captcha\":\"{{token}}\"}",
      "timeout": 30
    }
  }'

Response

Success

response.json

{
  "errorId": 0,
  "taskId": "task_abc123xyz789"
}

Error

error.json

{
  "errorId": 1,
  "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
  "errorDescription": "Invalid API key"
}

Error Codes

Code	Description
`ERROR_KEY_DOES_NOT_EXIST`	Invalid or missing API key
`ERROR_ZERO_BALANCE`	Insufficient credits
`ERROR_WRONG_TASK_DATA`	Invalid task parameters
`ERROR_TOO_MANY_REQUESTS`	Rate limit exceeded