Submit Job

Submit a job for background execution; returns immediately after acceptance.

POST /jobs/submit

cURL

cURL

curl --request POST \
  --url http://127.0.0.1:{port}/jobs/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "job": {
    "job_name": "hello-world",
    "tasks": [
      {
        "name": "hello-world/hello-world"
      }
    ],
    "agents": [
      {
        "name": "oracle"
      }
    ],
    "environment": {
      "type": "docker"
    }
  }
}
'

200

{
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "session_id": "<string>"
}

Authorizations

Authorization · string · header · required

Required only when the server has HARBOR_API_KEY configured.

Headers

Idempotency-Key · string | null

Required string length: 1 - 200

Harbor-API-Version · string · default: 2026-10-30

Body

application/json

job · JobConfig · object · required

Show child attributes

relay_inference · boolean · default: false

session_id · string | null

Required string length: 1 - 200

Pattern: ^[A-Za-z0-9_-]+$

Response

200

application/json

Successful Response

job_id · string<uuid> · required

session_id · string | null