Deploy Scoped Factory Job

POST

https://api.islo.dev/factories/:factory_id/jobs/:name/deploy

POST

/factories/:factory_id/jobs/:name/deploy

curl -X POST https://api.islo.dev/factories/factory_id/jobs/name/deploy \
     -H "X-Islo-Api-Version: X-Islo-Api-Version" \
     -H "Authorization: Bearer <api_key>" \
     -H "Content-Type: application/json" \
     -d '{
  "manifest": {
    "job": {
      "name": "string"
    },
    "run": {
      "tasks": [
        {
          "name": "string",
          "steps": [
            {}
          ]
        }
      ]
    }
  }
}'

{
  "content_hash": "string",
  "deployed_at": "2024-01-15T09:30:00Z",
  "id": "string",
  "manifest": {
    "job": {
      "name": "string",
      "description": "string",
      "params": {},
      "version": "string"
    },
    "run": {
      "tasks": [
        {
          "name": "string",
          "steps": [
            {
              "delete": true,
              "download": "string",
              "exec": [
                "string"
              ],
              "name": "string",
              "outputs": {},
              "pause": true,
              "resume": true,
              "run_agent": {
                "mode": "session",
                "harness": "codex",
                "command": [
                  "string"
                ],
                "effort": "string",
                "knowledge": [
                  {
                    "slug": "string",
                    "version": "string",
                    "type": "string"
                  }
                ],
                "mcp": [
                  {
                    "key": "string",
                    "url": "string"
                  }
                ],
                "model": "string",
                "model_provider": "islo",
                "prompt": {
                  "type": "string",
                  "value": null
                },
                "resume_prompt": {
                  "type": "string",
                  "value": null
                },
                "session": "string",
                "skills": [
                  "string"
                ]
              },
              "run_decision": {
                "questions": {},
                "state": {
                  "type": "string",
                  "value": null
                },
                "assets": {},
                "input_kind": "text",
                "model": "string"
              },
              "snapshot": {
                "name": "string"
              },
              "timeout": 1,
              "upload": "string",
              "user": "string",
              "workdir": "string"
            }
          ],
          "sandbox": {
            "cache_key": "string",
            "disk_gb": 10,
            "env": {},
            "environment": "string",
            "gateway_profile": "string",
            "image": "string",
            "init": {
              "type": "minimal"
            },
            "internet_enabled": true,
            "lifecycle": {
              "auto_resume": "never",
              "delete_after": 1,
              "pause_after": 1,
              "pause_after_idle": 1
            },
            "memory_mb": 2048,
            "mode": "provision",
            "name": "string",
            "setup_scripts": [
              {
                "script": "string",
                "name": ""
              }
            ],
            "snapshot_name": "string",
            "sources": [
              {
                "repo_url": "string",
                "branch": "string",
                "primary": false,
                "target_path": "string"
              }
            ],
            "template": {
              "name": "string",
              "version": 1
            },
            "vcpus": 2,
            "workdir": "string"
          }
        }
      ],
      "concurrency": 1,
      "fail_fast": true,
      "fanout": false,
      "region": "string",
      "resume_on_start": true,
      "sandbox": {
        "cache_key": "string",
        "disk_gb": 10,
        "env": {},
        "environment": "string",
        "gateway_profile": "string",
        "image": "string",
        "init": {
          "type": "minimal"
        },
        "internet_enabled": true,
        "lifecycle": {
          "auto_resume": "never",
          "delete_after": 1,
          "pause_after": 1,
          "pause_after_idle": 1
        },
        "memory_mb": 2048,
        "mode": "provision",
        "name": "string",
        "setup_scripts": [
          {
            "script": "string",
            "name": ""
          }
        ],
        "snapshot_name": "string",
        "sources": [
          {
            "repo_url": "string",
            "branch": "string",
            "primary": false,
            "target_path": "string"
          }
        ],
        "template": {
          "name": "string",
          "version": 1
        },
        "vcpus": 2,
        "workdir": "string"
      },
      "teardown_on_complete": true,
      "timeout": 1,
      "workdir": "string"
    },
    "outputs": {},
    "schedule": {
      "cron": "string",
      "enabled": true,
      "timezone": "UTC"
    },
    "verification": {
      "enabled": false,
      "gate": {
        "compare_to": "string",
        "min_pass_rate": 0.5
      }
    }
  },
  "version_number": 1
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

factory_idstringRequired

namestringRequired

Request

This endpoint expects an object.

manifestobjectRequired

Job manifest (authored as TOML or JSON, stored as JSON)

Response

Successful Response

content_hashstring

deployed_atdatetime

idstringformat: "uuid"

manifestobject

Full job.toml manifest (TOML or JSON authoring; stored as JSON).

version_numberinteger

Errors

422

Unprocessable Entity Error

Authentication

Path parameters

Headers

Request

Response

Errors