List deployed versions

GET

https://api.islo.dev/jobs/:name/versions

GET

/jobs/:name/versions

$ curl https://api.islo.dev/jobs/name/versions \
>      -H "Authorization: Bearer <api_key>" \
>      -H "Content-Type: application/json"

1 [
2   {
3     "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4     "version_number": 5,
5     "content_hash": "a1b2c3d4e5f67890123456789abcdef0",
6     "deployed_at": "2024-01-15T09:30:00Z",
7     "manifest": {
8       "job": {
9         "name": "data_processor",
10         "version": "v5.2.1",
11         "description": "Processes incoming data streams and outputs cleaned datasets",
12         "params": {
13           "input_path": {
14             "type": "string",
15             "required": true,
16             "description": "Path to input data files"
17           },
18           "max_retries": {
19             "type": "integer",
20             "description": "Maximum number of retry attempts",
21             "default": 3
22           },
23           "verbose": {
24             "type": "boolean",
25             "description": "Enable verbose logging",
26             "default": false
27           }
28         }
29       },
30       "run": {
31         "tasks": [
32           {
33             "name": "preprocessing",
34             "steps": [
35               {
36                 "name": "fetch_data",
37                 "workdir": "/preprocess",
38                 "timeout": 300,
39                 "user": "runner",
40                 "exec": [
41                   "python",
42                   "fetch_data.py"
43                 ],
44                 "snapshot": {
45                   "name": "fetch-data-snap"
46                 },
47                 "pause": false,
48                 "resume": false,
49                 "delete": false,
50                 "upload": "/data/input",
51                 "download": "/data/output"
52               }
53             ],
54             "sandbox": {
55               "mode": "provision",
56               "name": "dp-preprocess-sandbox",
57               "image": "islo/data-preprocessor:1.0.0",
58               "vcpus": 2,
59               "memory_mb": 4096,
60               "disk_gb": 20,
61               "snapshot_name": "preprocess-snap-v1",
62               "gateway_profile": "standard",
63               "init": {
64                 "type": "minimal"
65               },
66               "internet_enabled": true,
67               "workdir": "/preprocess",
68               "cache_key": "preprocess-cache-v1",
69               "env": {
70                 "DEBUG": "false"
71               },
72               "sources": [
73                 {
74                   "repo_url": "https://github.com/islo/data-preprocessor.git",
75                   "branch": "main",
76                   "target_path": "src"
77                 }
78               ],
79               "setup_scripts": [
80                 {
81                   "script": "npm install",
82                   "name": "Setup environment"
83                 }
84               ],
85               "lifecycle": {
86                 "auto_resume": "never",
87                 "delete_after": 43200,
88                 "pause_after": 3600,
89                 "pause_after_idle": 900
90               }
91             }
92           }
93         ],
94         "fail_fast": true,
95         "fanout": false,
96         "concurrency": 4,
97         "workdir": "/app",
98         "timeout": 3600,
99         "region": "us-west-2",
100         "teardown_on_complete": true,
101         "resume_on_start": false,
102         "sandbox": {
103           "mode": "provision",
104           "name": "dp-sandbox",
105           "image": "islo/data-processor:5.2.1",
106           "vcpus": 4,
107           "memory_mb": 8192,
108           "disk_gb": 50,
109           "snapshot_name": "dp-snapshot-v5",
110           "gateway_profile": "standard",
111           "init": {
112             "type": "minimal"
113           },
114           "internet_enabled": true,
115           "workdir": "/app",
116           "cache_key": "dp-cache-v5",
117           "env": {
118             "LOG_LEVEL": "info",
119             "MAX_THREADS": "8"
120           },
121           "sources": [
122             {
123               "repo_url": "https://github.com/islo/data-processor.git",
124               "branch": "release-5.2",
125               "target_path": "src"
126             }
127           ],
128           "setup_scripts": [
129             {
130               "script": "pip install -r requirements.txt",
131               "name": "Install dependencies"
132             }
133           ],
134           "lifecycle": {
135             "auto_resume": "on_activity",
136             "delete_after": 86400,
137             "pause_after": 7200,
138             "pause_after_idle": 1800
139           }
140         }
141       },
142       "schedule": {
143         "cron": "0 2 * * *",
144         "timezone": "UTC",
145         "enabled": true
146       },
147       "verification": {
148         "enabled": true,
149         "gate": {
150           "compare_to": "previous_version",
151           "min_pass_rate": 0.85
152         }
153       }
154     }
155   }
156 ]

Authentication

AuthorizationBearer

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

Path parameters

namestringRequired

Query parameters

limitintegerOptional1-200Defaults to 50

offsetintegerOptional>=0Defaults to 0

Response

Successful Response

idstringformat: "uuid"

version_numberinteger

content_hashstring

deployed_atdatetime

manifestobject

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

Errors

422

Unprocessable Entity Error