Create Task

Create a new captcha solving task.

POST/createTask

Request Body

Parameter	Type	Required	Description
`clientKey`	string	Yes	Your API key
`task`	object	Yes	Task configuration object

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.

Example Request

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
    }
  }'

Response

Success

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

Error

{
  "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