Start Task

Method: POST

Endpoint: /api/v1/task/run

Send the request body with Content-Type: application/json.

Request Example

{
    "task_slug": "01KK0G4W9W4JYTWEA55KMG5QKP",
    "callback_url": "https://your-domain.com/callback"
}

Parameters

Parameter	Example	Type	Required	Description
task_slug	01KK0DS99CJG4ZEC11VDXZ8Y2Q	String	Yes	Unique task identifier
callback_url	https://your-domain.com/callback	String	Yes	Callback URL for receiving Task results

Response Example

{
    "code": 0,
    "message": "success",
    "data": {
        "run_slug": "01KKDXV2G26BT7NH4ZQR2R4NPZ"
    }
}

Response Fields

Parameter	Example	Type	Description
code	0	Integer	Global status code
message	success	String	Response message
data	-	Object	Response payload
run_slug	01KKDXV2G26BT7NH4ZQR2R4NPZ	String	Unique run identifier

Error Response

{
    "code": 70001,
    "message": "Run record does not exist",
    "data": null
}

Error Fields

Parameter	Example	Type	Description
code	70001	Integer	Error code
message	Run record does not exist	String	Error description
data	null	Null	Empty payload