Skip to main content
POST
/
training-jobs
/
{job_id}
/
execute
{
  "job_id": "<string>",
  "execution_id": "<string>",
  "status": "<string>",
  "estimated_duration": 123,
  "resource_allocation": {
    "compute_tier": "<string>",
    "gpu_count": 123,
    "memory_gb": 123,
    "estimated_cost": 123
  },
  "execution_timeline": {
    "queue_position": 123,
    "estimated_start_time": {},
    "estimated_completion_time": {},
    "milestone_schedule": [
      {}
    ]
  },
  "monitoring_info": {
    "progress_url": "<string>",
    "webhook_configured": true,
    "log_retention_days": 123
  },
  "executed_at": {},
  "executed_by": "<string>"
}

​
Overview

Starts execution of a previously created training job. Training jobs are created in a pending state and must be explicitly executed. This allows you to review job configuration and schedule execution when appropriate.

​
Path Parameters

​
job_id
string
required
Unique identifier of the training job to execute

​
Request Body

​
execution_override
object
Override execution parameters (optional)
​
confirmation
object
Execution confirmation parameters

​
Response

​
job_id
string
required
ID of the executed training job
​
execution_id
string
required
Unique identifier for this execution instance
​
status
string
required
Updated job status after execution start
  • queued - Job queued for execution
  • preparing - Preparing training environment
  • training - Training started
​
estimated_duration
integer
required
Updated estimated duration in minutes
​
resource_allocation
object
required
Allocated resources for training
​
execution_timeline
object
required
Expected execution timeline
​
monitoring_info
object
required
Information for monitoring execution
​
executed_at
datetime
required
Timestamp when execution was started
​
executed_by
string
required
User ID who executed the job

​
Examples

curl -X POST https://api.judge.example.com/training-jobs/train_job_123/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "execution_override": {
      "priority": "high",
      "resource_allocation": "high_performance"
    },
    "confirmation": {
      "acknowledge_cost": true,
      "backup_confirmation": true
    }
  }'

curl -X POST https://api.judge.example.com/training-jobs/train_job_456/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "execution_override": {
      "resource_allocation": "minimal",
      "max_duration_minutes": 120
    },
    "confirmation": {
      "acknowledge_cost": true
    }
  }'

curl -X POST https://api.judge.example.com/training-jobs/train_job_running/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST https://api.judge.example.com/training-jobs/train_job_expensive/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "execution_override": {
      "resource_allocation": "high_performance"
    }
  }'