Create a managed job

Launch an admitted Harbor-compatible job and return its durable handle.

POST /api/v1/users/{user_id}/harbor/jobs

Create a managed job

cURL

curl --request POST \
  --url https://sprites-gateway.api.synthlabs.ai/api/v1/users/{user_id}/harbor/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "config": {}
}'

201

{
  "bundle_url": "<string>",
  "events_url": "<string>",
  "harbor_version": "<string>",
  "job_id": "<string>",
  "kind": "job",
  "state": "<string>",
  "status_url": "<string>",
  "accepted": true,
  "next_commands": [
    "<string>"
  ],
  "partial_support": {},
  "submission_disposition": "created",
  "trial_id": "<string>",
  "unsupported_fields": [
    {
      "code": "<string>",
      "field": "<string>",
      "reason": "<string>",
      "severity": "warning"
    }
  ],
  "warnings": [
    {
      "code": "<string>",
      "field": "<string>",
      "reason": "<string>",
      "severity": "warning"
    }
  ]
}

Authorizations

Authorization · string · header · required

Synth customer access token for the current user and organization.

Headers

Idempotency-Key · string | null

Path Parameters

user_id · string<uuid> · required

Body

application/json

Request envelope for side-effect-free Harbor config translation.

config · Config · object · required

client_context · HarborClientContext · object

Optional diagnostic metadata from a Harbor-compatible client.

Show child attributes

harbor_commit · string | null

harbor_version · string · default: 0.13.0

source · string · default: synth-cli

strict · boolean · default: true

Response

201

application/json

Successful Response

Managed execution receipt for a Harbor-compatible job.

bundle_url · string | null · required

events_url · string | null · required

harbor_version · string · required

job_id · string · required

kind · enum<string> · required

Available options: job, trial

state · string · required

status_url · string · required

accepted · boolean · default: true

next_commands · string[]

partial_support · Partial Support · object

submission_disposition · enum<string> · default: created

Available options: created, replayed

trial_id · string | null

unsupported_fields · HarborFieldFinding · object[]

Show child attributes

warnings · HarborFieldFinding · object[]

Show child attributes