Jobs¶
This page outlines the endpoints that create and manage DataRobot model evaluation jobs.
List tasks¶
Operation path: GET /api/v2/status/
Authentication requirements: BearerAuth
List the async tasks that are currently running for your account.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | true | This many results will be skipped. |
| limit | query | integer | true | At most this many results are returned. If 0, all results. |
Example responses¶
200 Response
{
"properties": {
"count": {
"description": "Number of items returned on this page.",
"type": "integer"
},
"data": {
"description": "An array of currently running async status jobs.",
"items": {
"properties": {
"code": {
"description": "If no error occurred, 0. Otherwise, may contain a status code reflecting the error.",
"type": "integer"
},
"created": {
"description": "The time the status record was created.",
"format": "date-time",
"type": "string"
},
"description": {
"description": "A description of the task being performed, if applicable",
"type": [
"string",
"null"
]
},
"message": {
"description": "May contain further information about the status.",
"type": [
"string",
"null"
]
},
"status": {
"description": "The status of the task.",
"enum": [
"ABORTED",
"COMPLETED",
"ERROR",
"EXPIRED",
"INITIALIZED",
"RUNNING"
],
"type": "string"
},
"statusId": {
"description": "The ID of the status object.",
"type": "string"
},
"statusType": {
"description": "The type of thing being created by the Task, if applicable.",
"type": [
"string",
"null"
]
},
"type": {
"description": "The type of thing being created by the Task, if applicable.",
"enum": [
"CustomModelBlueprintBuild",
"CustomModelFeatureImpact",
"Testing",
"customModelWaitForServer",
"ManagedImageBuild",
"Dataset",
"LongRunningServiceControllerOperation",
"ProjectPermanentDeletion"
],
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"created",
"description",
"message",
"status",
"statusId"
],
"type": "object"
},
"type": "array"
},
"next": {
"description": "URL pointing to the next page (if null, there is no next page).",
"format": "uri",
"type": [
"string",
"null"
]
},
"previous": {
"description": "URL pointing to the previous page (if null, there is no previous page).",
"format": "uri",
"type": [
"string",
"null"
]
}
},
"required": [
"data",
"next",
"previous"
],
"type": "object"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The list of statuses | StatusListResponse |
Delete a task by status ID¶
Operation path: DELETE /api/v2/status/{statusId}/
Authentication requirements: BearerAuth
Destroy an async status object.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| statusId | path | string | true | The ID of the status object. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | Successfully deleted | None |
Get task status by status ID¶
Operation path: GET /api/v2/status/{statusId}/
Authentication requirements: BearerAuth
Check the status of an asynchronous task such as project creation.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| statusId | path | string | true | The ID of the status object. |
Example responses¶
200 Response
{
"properties": {
"code": {
"description": "If no error occurred, 0. Otherwise, may contain a status code reflecting the error.",
"type": "integer"
},
"created": {
"description": "The time the status record was created.",
"format": "date-time",
"type": "string"
},
"description": {
"description": "A description of the task being performed, if applicable",
"type": [
"string",
"null"
]
},
"message": {
"description": "May contain further information about the status.",
"type": [
"string",
"null"
]
},
"status": {
"description": "The status of the task.",
"enum": [
"ABORTED",
"COMPLETED",
"ERROR",
"EXPIRED",
"INITIALIZED",
"RUNNING"
],
"type": "string"
},
"statusId": {
"description": "The ID of the status object.",
"type": "string"
},
"statusType": {
"description": "The type of thing being created by the Task, if applicable.",
"type": [
"string",
"null"
]
},
"type": {
"description": "The type of thing being created by the Task, if applicable.",
"enum": [
"CustomModelBlueprintBuild",
"CustomModelFeatureImpact",
"Testing",
"customModelWaitForServer",
"ManagedImageBuild",
"Dataset",
"LongRunningServiceControllerOperation",
"ProjectPermanentDeletion"
],
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"created",
"description",
"message",
"status",
"statusId"
],
"type": "object"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The status of the asynchronous task | StatusRetrieveResponse |
| 303 | See Other | Task is completed, see Location header for the location of a new resource | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 200 | Location | string | A url that can be polled to check the status. |
Schemas¶
StatusListResponse
{
"properties": {
"count": {
"description": "Number of items returned on this page.",
"type": "integer"
},
"data": {
"description": "An array of currently running async status jobs.",
"items": {
"properties": {
"code": {
"description": "If no error occurred, 0. Otherwise, may contain a status code reflecting the error.",
"type": "integer"
},
"created": {
"description": "The time the status record was created.",
"format": "date-time",
"type": "string"
},
"description": {
"description": "A description of the task being performed, if applicable",
"type": [
"string",
"null"
]
},
"message": {
"description": "May contain further information about the status.",
"type": [
"string",
"null"
]
},
"status": {
"description": "The status of the task.",
"enum": [
"ABORTED",
"COMPLETED",
"ERROR",
"EXPIRED",
"INITIALIZED",
"RUNNING"
],
"type": "string"
},
"statusId": {
"description": "The ID of the status object.",
"type": "string"
},
"statusType": {
"description": "The type of thing being created by the Task, if applicable.",
"type": [
"string",
"null"
]
},
"type": {
"description": "The type of thing being created by the Task, if applicable.",
"enum": [
"CustomModelBlueprintBuild",
"CustomModelFeatureImpact",
"Testing",
"customModelWaitForServer",
"ManagedImageBuild",
"Dataset",
"LongRunningServiceControllerOperation",
"ProjectPermanentDeletion"
],
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"created",
"description",
"message",
"status",
"statusId"
],
"type": "object"
},
"type": "array"
},
"next": {
"description": "URL pointing to the next page (if null, there is no next page).",
"format": "uri",
"type": [
"string",
"null"
]
},
"previous": {
"description": "URL pointing to the previous page (if null, there is no previous page).",
"format": "uri",
"type": [
"string",
"null"
]
}
},
"required": [
"data",
"next",
"previous"
],
"type": "object"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | false | Number of items returned on this page. | |
| data | [StatusRetrieveResponse] | true | An array of currently running async status jobs. | |
| next | string,null(uri) | true | URL pointing to the next page (if null, there is no next page). | |
| previous | string,null(uri) | true | URL pointing to the previous page (if null, there is no previous page). |
StatusRetrieveResponse
{
"properties": {
"code": {
"description": "If no error occurred, 0. Otherwise, may contain a status code reflecting the error.",
"type": "integer"
},
"created": {
"description": "The time the status record was created.",
"format": "date-time",
"type": "string"
},
"description": {
"description": "A description of the task being performed, if applicable",
"type": [
"string",
"null"
]
},
"message": {
"description": "May contain further information about the status.",
"type": [
"string",
"null"
]
},
"status": {
"description": "The status of the task.",
"enum": [
"ABORTED",
"COMPLETED",
"ERROR",
"EXPIRED",
"INITIALIZED",
"RUNNING"
],
"type": "string"
},
"statusId": {
"description": "The ID of the status object.",
"type": "string"
},
"statusType": {
"description": "The type of thing being created by the Task, if applicable.",
"type": [
"string",
"null"
]
},
"type": {
"description": "The type of thing being created by the Task, if applicable.",
"enum": [
"CustomModelBlueprintBuild",
"CustomModelFeatureImpact",
"Testing",
"customModelWaitForServer",
"ManagedImageBuild",
"Dataset",
"LongRunningServiceControllerOperation",
"ProjectPermanentDeletion"
],
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"created",
"description",
"message",
"status",
"statusId"
],
"type": "object"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| code | integer | true | If no error occurred, 0. Otherwise, may contain a status code reflecting the error. | |
| created | string(date-time) | true | The time the status record was created. | |
| description | string,null | true | A description of the task being performed, if applicable | |
| message | string,null | true | May contain further information about the status. | |
| status | string | true | The status of the task. | |
| statusId | string | true | The ID of the status object. | |
| statusType | string,null | false | The type of thing being created by the Task, if applicable. | |
| type | string,null | false | The type of thing being created by the Task, if applicable. |
Enumerated Values¶
| Property | Value |
|---|---|
| status | [ABORTED, COMPLETED, ERROR, EXPIRED, INITIALIZED, RUNNING] |
| type | [CustomModelBlueprintBuild, CustomModelFeatureImpact, Testing, customModelWaitForServer, ManagedImageBuild, Dataset, LongRunningServiceControllerOperation, ProjectPermanentDeletion] |