Tasks APISubmit & Monitor ML Tasks
Create, manage, and execute machine learning tasks across the ML Bridge distributed compute network.
7 Endpoints
Webhooks
Batch Processing
Task Lifecycle
Tasks progress through these stages from submission to completion.
1
Created
Submitted to network
2
Assigned
Matched with provider
3
Executing
Running on compute
4
Completed
Results available
Endpoints
Complete list of Tasks API endpoints.
GET
List tasks/api/tasksRetrieve a paginated list of tasks with optional filtering.
pagelimitstatusmodel_id
POST
Create task/api/tasksCreate a new ML task with input data, model selection, and execution parameters.
GET
Get task details/api/tasks/{id}Get detailed information about a specific task including status and results.
POST
Cancel task/api/tasks/{id}/cancelCancel a pending or executing task. Only available for task creators.
GET
Get results/api/tasks/{id}/resultsDownload the results of a completed task.
format: json|csv|binary
GET
Get logs/api/tasks/{id}/logsRetrieve execution logs and debugging information for a task.
POST
Batch submit/api/tasks/batchSubmit multiple tasks in a single request. Max 100 tasks per batch.
Task Status Codes
Active States
CREATEDAwaiting assignment
ASSIGNEDMatched with provider
EXECUTINGCurrently running
Final States
COMPLETEDSuccessfully finished
FAILEDExecution error
CANCELLEDCancelled by user
Example Request
Request
POST /api/tasks
Authorization: Bearer <token>
Content-Type: application/json
{
"model_id": "model_123",
"input_data": {
"text": "Analyze this sentiment",
"parameters": {
"temperature": 0.7,
"max_tokens": 100
}
},
"compute_requirements": {
"gpu_memory": "8GB"
},
"callback_url": "https://..."
}Response
{
"task_id": "task_456",
"status": "CREATED",
"model_id": "model_123",
"created_at": "2025-01-15T10:30:00Z",
"estimated_completion": "2025-01-15T10:35:00Z",
"cost_estimate": {
"amount": "0.05",
"currency": "USDC"
}
}Standard Tier
Tasks per hour50
Concurrent executions10
Batch requests/hr5
Premium Tier
Tasks per hour500
Concurrent executions50
Batch requests/hr25