Get Job Step

GET

https://host.com/apis/jobs/v2/workspaces/:workspace/jobs/:job/steps/:name

GET

/apis/jobs/v2/workspaces/:workspace/jobs/:job/steps/:name

$ curl https://host.com/apis/jobs/v2/workspaces/workspace/jobs/job/steps/name \
>      -H "Content-Type: application/json"

1 {
2   "workspace": "analytics-team@company.com",
3   "attempt_id": "attempt-20240612-001",
4   "id": "step-9f8b7c6d-1234-4a56-b789-0a1b2c3d4e5f",
5   "created_at": "2024-06-12T07:55:00Z",
6   "created_by": "jane.doe@company.com",
7   "updated_at": "2024-06-12T08:15:00Z",
8   "updated_by": "jane.doe@company.com",
9   "entity_id": "step-9f8b7c6d-1234-4a56-b789-0a1b2c3d4e5f",
10   "parent": "attempt-20240612-001",
11   "db_version": 3,
12   "name": "data-preprocessing",
13   "project": "customer-churn-prediction",
14   "config": {
15     "input_path": "/data/raw/customer_data.csv",
16     "output_path": "/data/processed/customer_data_cleaned.csv",
17     "steps": [
18       "remove_nulls",
19       "normalize",
20       "encode_categorical"
21     ]
22   },
23   "status": "active",
24   "status_details": {
25     "started_at": "2024-06-12T08:00:00Z",
26     "progress_percent": 45,
27     "current_task": "normalizing features"
28   },
29   "error_details": {}
30 }

Get a specific job step.

Path parameters

jobstringRequired

namestringRequired

workspacestringRequired

Response

Successful Response

workspacestringformat: "^[\w\-\+.@:]+$"

Workspace identifier

attempt_idstring

Parent attempt ID

idstringRead-only

created_atdatetimeRead-only

created_bystring or nullRead-only

updated_atdatetimeRead-only

updated_bystring or nullRead-only

entity_idstringRead-only

Alias for id for backwards compatibility.

parentstringRead-only

Parent entity ID for nested entities.

db_versionintegerRead-only

Database version of the entity for optimistic locking.

namestringOptionalDefaults to

Entity name within the workspace

projectstringOptional

The name of the project associated with this entity.

configmap from strings to anyOptional

Configuration for the step

statusenumOptionalDefaults to created

Step status

status_detailsmap from strings to anyOptional

Status details

error_detailsmap from strings to anyOptional

Error details if applicable

Errors

404

Not Found Error

422

Unprocessable Entity Error