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-8e9f-0a1b2c3d4e5f",
5   "created_at": "2024-01-15T09:30:00Z",
6   "created_by": "jane.doe@company.com",
7   "updated_at": "2024-06-12T10:15:00Z",
8   "updated_by": "jane.doe@company.com",
9   "entity_id": "step_9f8b7c6d-1234-4a56-8e9f-0a1b2c3d4e5f",
10   "parent": "attempt_20240612_001",
11   "name": "data_ingestion_step",
12   "project": "customer-churn-prediction",
13   "config": {
14     "source": "s3://company-data-bucket/raw/customer_data.csv",
15     "retry_limit": 3,
16     "timeout_seconds": 600
17   },
18   "status": "active",
19   "status_details": {
20     "last_updated": "2024-06-12T10:15:00Z",
21     "progress": "75%",
22     "current_task": "Downloading data files"
23   },
24   "error_details": {}
25 }

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.

namestringDefaults to

Entity name within the workspace

projectstring

The name of the project associated with this entity.

configmap from strings to any

Configuration for the step

statusenumDefaults to created

Step status

status_detailsmap from strings to any

Status details

error_detailsmap from strings to any

Error details if applicable

Errors

404

Not Found Error

422

Unprocessable Entity Error