> This page is for Itential Platform On-Prem, version 6 (default).
> For other versions, use one of these documentation indexes:
> - 6 (default): https://docs-test.itntl.com/itential-platform/6/llms.txt
> - 2023.2: https://docs-test.itntl.com/itential-platform/2023-2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-test.itntl.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-test.itntl.com/_mcp/server.

# Get a job

GET https://example.itential.io/operations-manager/jobs/{id}

Returns a Job.

Reference: https://docs-test.itntl.com/itential-platform/6/api-reference/operations-manager/get-job

## Authentication

- `Authorization` header (basic auth, required) — Basic authentication of the form `Basic <base64(username:password)>`.

## Request

### Path parameters

- `id` (string, required) — The id of the Job to get.

### Query parameters

- `include` (string, optional) — Inclusive projection operator formatted as a comma-delineated list. '_id' will be included implicitly unless excluded with 'exclude=_id'. May only be used in conjunction with 'exclude' when 'exclude=_id'.
- `exclude` (string, optional) — Exclusive projection operator formatted as a comma-delineated list. May only be used in conjunction with 'include' when 'exclude=_id'.
- `dereference` (string, optional) — Designates foreign key fields to dereference in the API output.

## Response

### 200

The requested Job.

- `message` (string, required) — A human-readable message summarizing the result of the operation
- `data` (operations-manager_job-api, required) — Any successfully retrieved information related to the request.
- `metadata` (map from string to any, required) — Any structured, wordy or machine-readable information related to the result of the operation. For success responses, this may contain information like pagination values from a search operation.

## Errors

### 500 Internal Server Error

Error response from API

- `any`

## Types

### operations-manager_job-api

A Job document in API response format.

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `uuid` (string, optional)
- `font_size` (integer, optional)
- `type` (enum, optional)
  - Allowed values: `automation`, `resource:action`, `resource:compliance`
- `created` (string, optional) — An ISO 8601 date string
- `last_updated` (string, optional) — An ISO 8601 date string
- `createdVersion` (string, optional)
- `lastUpdatedVersion` (string, optional)
- `canvasVersion` (enum, optional)
  - Allowed values: `1`, `1.5`, `2`, `3`
- `encodingVersion` (enum, optional)
  - Allowed values: `1`
- `migrationVersion` (integer, optional) — The current document version of this document.
- `name` (string, optional) — The name of the document
- `description` (string, optional, nullable)
- `preAutomationTime` (double, optional)
- `sla` (double, optional)
- `decorators` (list of OperationsManagerJobApiDecoratorsItems, optional)
- `transitions` (OperationsManagerJobApiTransitions, optional)
- `status` (enum, optional)
  - Allowed values: `error`, `complete`, `running`, `canceled`, `incomplete`, `paused`
- `variables` (OperationsManagerJobApiVariables, optional)
- `tags` (list of any, optional)
- `error` (list of OperationsManagerJobApiErrorItems, optional)
- `warnings` (list of OperationsManagerJobApiWarningsItems, optional)
- `ancestors` (list of string, optional, nullable)
- `validationErrors` (list of OperationsManagerJobApiValidationErrorsItems, optional)
- `namespace` (OperationsManagerJobApiNamespace, optional)
- `mocked` (boolean, optional)
- `created_by` (OperationsManagerJobApiCreatedBy, optional, nullable)
- `last_updated_by` (OperationsManagerJobApiLastUpdatedBy, optional, nullable)
- `tasks` (OperationsManagerJobApiTasks, optional)
- `parent` (OperationsManagerJobApiParent, optional)
- `errorHandler` (OperationsManagerJobApiErrorHandler, optional, nullable)
- `groups` (list of OperationsManagerJobApiGroupsItems, optional)
- `watchers` (list of OperationsManagerJobApiWatchersItems, optional)
- `metrics` (OperationsManagerJobApiMetrics, optional)
- `output` (OperationsManagerJobApiOutput, optional)
- `outputData` (OperationsManagerJobApiOutputData, optional)

### OperationsManagerJobApiDecoratorsItems

- `type` (any, optional)
- `pointer` (string, optional)

### OperationsManagerJobApiTransitions

### OperationsManagerJobApiVariables

### OperationsManagerJobApiErrorItems

- `task` (OperationsManagerJobApiErrorItemsTask, optional)
- `message` (OperationsManagerJobApiErrorItemsMessage, optional)
- `timestamp` (double, optional) — The time at which this error occurred, designated by a unix timestamp

### OperationsManagerJobApiWarningsItems

- `task` (OperationsManagerJobApiWarningsItemsTask, optional)
- `name` (string, optional) — The name of the document
- `message` (OperationsManagerJobApiWarningsItemsMessage, optional)

### OperationsManagerJobApiValidationErrorsItems

- `keyword` (string, optional)
- `instancePath` (string, optional)
- `schemaPath` (string, optional)
- `params` (OperationsManagerJobApiValidationErrorsItemsParams, optional)
- `message` (string, optional)

### OperationsManagerJobApiNamespace

### OperationsManagerJobApiCreatedBy

### OperationsManagerJobApiLastUpdatedBy

### OperationsManagerJobApiTasks

- `workflow_start` (OperationsManagerJobApiTasksWorkflowStart, optional)
- `workflow_end` (OperationsManagerJobApiTasksWorkflowEnd, optional)
- `error_handler` (OperationsManagerJobApiTasksErrorHandler, optional)

### OperationsManagerJobApiParent

- `job` (OperationsManagerJobApiParentJob, optional)
- `task` (string, optional)
- `iteration` (double, optional)
- `element` (double, optional)

### OperationsManagerJobApiErrorHandler

- `actor` (OperationsManagerJobApiErrorHandlerActor, optional)
- `groups` (list of OperationsManagerJobApiErrorHandlerGroupsItems, optional)
- `iterations` (list of OperationsManagerJobApiErrorHandlerIterationsItems, optional)

### OperationsManagerJobApiGroupsItems

### OperationsManagerJobApiWatchersItems

### OperationsManagerJobApiMetrics

- `start_time` (double, optional)
- `progress` (double, optional)
- `end_time` (double, optional)
- `user` (OperationsManagerJobApiMetricsUser, optional, nullable)
- `owner` (OperationsManagerJobApiMetricsOwner, optional, nullable)

### OperationsManagerJobApiOutput

### OperationsManagerJobApiOutputData

### OperationsManagerJobApiErrorItemsTask

### OperationsManagerJobApiErrorItemsMessage

### OperationsManagerJobApiWarningsItemsTask

### OperationsManagerJobApiWarningsItemsMessage

### OperationsManagerJobApiValidationErrorsItemsParams

### OperationsManagerJobApiCreatedBy2

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `username` (string, optional)
- `firstname` (string, optional)
- `memberOf` (list of OperationsManagerJobApiCreatedByOneOf2MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiCreatedByOneOf2AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `lastLogin` (string, optional) — An ISO 8601 date string
- `_meta` (OperationsManagerJobApiCreatedByOneOf2Meta, optional)
- `email` (string, optional)

### OperationsManagerJobApiLastUpdatedBy2

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `username` (string, optional)
- `firstname` (string, optional)
- `memberOf` (list of OperationsManagerJobApiLastUpdatedByOneOf2MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiLastUpdatedByOneOf2AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `lastLogin` (string, optional) — An ISO 8601 date string
- `_meta` (OperationsManagerJobApiLastUpdatedByOneOf2Meta, optional)
- `email` (string, optional)

### OperationsManagerJobApiTasksWorkflowStart

- `x` (double, optional) — Stores the x coordinate used by canvasType = 1 workflows
- `y` (double, optional) — Stores the y coordinate used by canvasType = 1 workflows
- `gridCoordinate` (OperationsManagerJobApiTasksWorkflowStartGridCoordinate, optional) — Stores the coordinates used by canvasType = 2 workflows
- `name` (any, optional)
- `summary` (any, optional)
- `taskId` (any, optional)
- `metrics` (OperationsManagerJobApiTasksWorkflowStartMetrics, optional)
- `groups` (list of OperationsManagerJobApiTasksWorkflowStartGroupsItems, optional)
- `iterations` (list of OperationsManagerJobApiTasksWorkflowStartIterationsItems, optional)

### OperationsManagerJobApiTasksWorkflowEnd

- `x` (double, optional) — Stores the x coordinate used by canvasType = 1 workflows
- `y` (double, optional) — Stores the y coordinate used by canvasType = 1 workflows
- `gridCoordinate` (OperationsManagerJobApiTasksWorkflowEndGridCoordinate, optional) — Stores the coordinates used by canvasType = 2 workflows
- `name` (any, optional)
- `summary` (any, optional)
- `taskId` (any, optional)
- `endTasks` (OperationsManagerJobApiTasksWorkflowEndEndTasks, optional)
- `metrics` (OperationsManagerJobApiTasksWorkflowEndMetrics, optional)
- `groups` (list of OperationsManagerJobApiTasksWorkflowEndGroupsItems, optional)
- `iterations` (list of OperationsManagerJobApiTasksWorkflowEndIterationsItems, optional)

### OperationsManagerJobApiTasksErrorHandler

- `x` (double, optional) — Stores the x coordinate used by canvasType = 1 workflows
- `y` (double, optional) — Stores the y coordinate used by canvasType = 1 workflows
- `gridCoordinate` (OperationsManagerJobApiTasksErrorHandlerGridCoordinate, optional) — Stores the coordinates used by canvasType = 2 workflows
- `name` ("childJob", optional)
- `location` (enum, optional)
  - Allowed values: `Adapter`, `Application`, `Broker`
- `locationType` (string, optional, nullable)
- `app` (string, optional)
- `canvasName` (string, optional)
- `displayName` (string, optional)
- `summary` (string, optional)
- `description` (string, optional)
- `variables` (OperationsManagerJobApiTasksErrorHandlerVariables, optional)
- `deprecated` (boolean, optional)
- `scheduled` (boolean, optional)
- `matched` (list of OperationsManagerJobApiTasksErrorHandlerMatchedItems, optional)
- `status` (enum, optional)
  - Allowed values: `incomplete`, `scheduled`, `running`, `complete`, `canceled`, `error`, `failure`, `paused`
- `previous` (OperationsManagerJobApiTasksErrorHandlerPrevious, optional)
- `taskId` (OperationsManagerJobApiTasksErrorHandlerTaskId, optional)
- `transitions` (OperationsManagerJobApiTasksErrorHandlerTransitions, optional)
- `serverId` (string, optional)
- `start_time` (string, optional) — An ISO 8601 date string
- `end_time` (double, optional)
- `finish_state` (enum, optional)
  - Allowed values: `success`, `failure`, `error`
- `retrySettings` (OperationsManagerJobApiTasksErrorHandlerRetrySettings, optional, nullable)
- `mockId` (string, optional) — A UUIDv4 identifier.
- `type` (any, optional)
- `actor` (OperationsManagerJobApiTasksErrorHandlerActor, optional)
- `groups` (list of OperationsManagerJobApiTasksErrorHandlerGroupsItems, optional)
- `iterations` (list of OperationsManagerJobApiTasksErrorHandlerIterationsItems, optional)

### OperationsManagerJobApiParentJob

### OperationsManagerJobApiErrorHandlerActor

### OperationsManagerJobApiErrorHandlerGroupsItems

### OperationsManagerJobApiErrorHandlerIterationsItems

### OperationsManagerJobApiGroupsItems1

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `name` (string, optional)
- `description` (string, optional)
- `memberOf` (list of OperationsManagerJobApiGroupsItemsOneOf1MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiGroupsItemsOneOf1AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `_meta` (OperationsManagerJobApiGroupsItemsOneOf1Meta, optional)

### OperationsManagerJobApiWatchersItems2

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `username` (string, optional)
- `firstname` (string, optional)
- `memberOf` (list of OperationsManagerJobApiWatchersItemsOneOf2MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiWatchersItemsOneOf2AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `lastLogin` (string, optional) — An ISO 8601 date string
- `_meta` (OperationsManagerJobApiWatchersItemsOneOf2Meta, optional)
- `email` (string, optional)

### OperationsManagerJobApiMetricsUser

### OperationsManagerJobApiMetricsOwner

### OperationsManagerJobApiCreatedByOneOf2MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiCreatedByOneOf2AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiCreatedByOneOf2Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiLastUpdatedByOneOf2MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiLastUpdatedByOneOf2AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiLastUpdatedByOneOf2Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiTasksWorkflowStartGridCoordinate

Stores the coordinates used by canvasType = 2 workflows

- `x` (double, optional)
- `y` (double, optional)

### OperationsManagerJobApiTasksWorkflowStartMetrics

- `start_time` (double, optional)
- `finish_state` (enum, optional)
  - Allowed values: `success`, `failure`, `error`
- `user` (OperationsManagerJobApiTasksWorkflowStartMetricsUser, optional, nullable)

### OperationsManagerJobApiTasksWorkflowStartGroupsItems

### OperationsManagerJobApiTasksWorkflowStartIterationsItems

### OperationsManagerJobApiTasksWorkflowEndGridCoordinate

Stores the coordinates used by canvasType = 2 workflows

- `x` (double, optional)
- `y` (double, optional)

### OperationsManagerJobApiTasksWorkflowEndEndTasks

- `incomplete` (list of OperationsManagerJobApiTasksWorkflowEndEndTasksIncompleteItems, optional)
- `complete` (list of OperationsManagerJobApiTasksWorkflowEndEndTasksCompleteItems, optional)
- `error` (list of OperationsManagerJobApiTasksWorkflowEndEndTasksErrorItems, optional)

### OperationsManagerJobApiTasksWorkflowEndMetrics

- `end_time` (double, optional)
- `run_time` (double, optional)

### OperationsManagerJobApiTasksWorkflowEndGroupsItems

### OperationsManagerJobApiTasksWorkflowEndIterationsItems

### OperationsManagerJobApiTasksErrorHandlerGridCoordinate

Stores the coordinates used by canvasType = 2 workflows

- `x` (double, optional)
- `y` (double, optional)

### OperationsManagerJobApiTasksErrorHandlerVariables

- `incoming` (OperationsManagerJobApiTasksErrorHandlerVariablesIncoming, optional)
- `outgoing` (OperationsManagerJobApiTasksErrorHandlerVariablesOutgoing, optional)
- `error` (string, optional)
- `decorators` (list of OperationsManagerJobApiTasksErrorHandlerVariablesDecoratorsItems, optional)

### OperationsManagerJobApiTasksErrorHandlerMatchedItems

- `key` (string, optional)
- `highlightString` (string, optional)

### OperationsManagerJobApiTasksErrorHandlerPrevious

- `incomplete` (list of OperationsManagerJobApiTasksErrorHandlerPreviousIncompleteItems, optional)
- `complete` (list of OperationsManagerJobApiTasksErrorHandlerPreviousCompleteItems, optional)
- `error` (list of OperationsManagerJobApiTasksErrorHandlerPreviousErrorItems, optional)

### OperationsManagerJobApiTasksErrorHandlerTaskId

### OperationsManagerJobApiTasksErrorHandlerTransitions

- `success` (list of OperationsManagerJobApiTasksErrorHandlerTransitionsSuccessItems, optional)
- `failure` (list of OperationsManagerJobApiTasksErrorHandlerTransitionsFailureItems, optional)
- `error` (list of OperationsManagerJobApiTasksErrorHandlerTransitionsErrorItems, optional)

### OperationsManagerJobApiTasksErrorHandlerRetrySettings

- `state` (list of enum, optional)
  - Allowed values: `success`, `error`, `failure`
- `autoRetry` (boolean, optional)
- `limit` (integer, optional)
- `delay` (integer, optional)
- `count` (integer, optional)
- `finishedRetrying` (boolean, optional)

### OperationsManagerJobApiTasksErrorHandlerActor

### OperationsManagerJobApiTasksErrorHandlerGroupsItems

### OperationsManagerJobApiTasksErrorHandlerIterationsItems

### OperationsManagerJobApiErrorHandlerGroupsItems1

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `name` (string, optional)
- `description` (string, optional)
- `memberOf` (list of OperationsManagerJobApiErrorHandlerGroupsItemsOneOf1MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiErrorHandlerGroupsItemsOneOf1AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `_meta` (OperationsManagerJobApiErrorHandlerGroupsItemsOneOf1Meta, optional)

### OperationsManagerJobApiGroupsItemsOneOf1MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiGroupsItemsOneOf1AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiGroupsItemsOneOf1Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiWatchersItemsOneOf2MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiWatchersItemsOneOf2AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiWatchersItemsOneOf2Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiMetricsUser2

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `username` (string, optional)
- `firstname` (string, optional)
- `memberOf` (list of OperationsManagerJobApiMetricsUserOneOf2MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiMetricsUserOneOf2AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `lastLogin` (string, optional) — An ISO 8601 date string
- `_meta` (OperationsManagerJobApiMetricsUserOneOf2Meta, optional)
- `email` (string, optional)

### OperationsManagerJobApiMetricsOwner2

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `username` (string, optional)
- `firstname` (string, optional)
- `memberOf` (list of OperationsManagerJobApiMetricsOwnerOneOf2MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiMetricsOwnerOneOf2AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `lastLogin` (string, optional) — An ISO 8601 date string
- `_meta` (OperationsManagerJobApiMetricsOwnerOneOf2Meta, optional)
- `email` (string, optional)

### OperationsManagerJobApiTasksWorkflowStartMetricsUser

### OperationsManagerJobApiTasksWorkflowStartGroupsItems1

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `name` (string, optional)
- `description` (string, optional)
- `memberOf` (list of OperationsManagerJobApiTasksWorkflowStartGroupsItemsOneOf1MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiTasksWorkflowStartGroupsItemsOneOf1AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `_meta` (OperationsManagerJobApiTasksWorkflowStartGroupsItemsOneOf1Meta, optional)

### OperationsManagerJobApiTasksWorkflowEndEndTasksIncompleteItems

### OperationsManagerJobApiTasksWorkflowEndEndTasksCompleteItems

### OperationsManagerJobApiTasksWorkflowEndEndTasksErrorItems

### OperationsManagerJobApiTasksWorkflowEndGroupsItems1

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `name` (string, optional)
- `description` (string, optional)
- `memberOf` (list of OperationsManagerJobApiTasksWorkflowEndGroupsItemsOneOf1MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiTasksWorkflowEndGroupsItemsOneOf1AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `_meta` (OperationsManagerJobApiTasksWorkflowEndGroupsItemsOneOf1Meta, optional)

### OperationsManagerJobApiTasksErrorHandlerVariablesIncoming

### OperationsManagerJobApiTasksErrorHandlerVariablesOutgoing

### OperationsManagerJobApiTasksErrorHandlerVariablesDecoratorsItems

- `type` (any, optional)
- `pointer` (string, optional)

### OperationsManagerJobApiTasksErrorHandlerPreviousIncompleteItems

### OperationsManagerJobApiTasksErrorHandlerPreviousCompleteItems

### OperationsManagerJobApiTasksErrorHandlerPreviousErrorItems

### OperationsManagerJobApiTasksErrorHandlerTransitionsSuccessItems

- `task` (OperationsManagerJobApiTasksErrorHandlerTransitionsSuccessItemsTask, optional)
- `type` (enum, optional)
  - Allowed values: `standard`, `revert`, `loop`

### OperationsManagerJobApiTasksErrorHandlerTransitionsFailureItems

- `task` (OperationsManagerJobApiTasksErrorHandlerTransitionsFailureItemsTask, optional)
- `type` (enum, optional)
  - Allowed values: `standard`, `revert`, `loop`

### OperationsManagerJobApiTasksErrorHandlerTransitionsErrorItems

- `task` (OperationsManagerJobApiTasksErrorHandlerTransitionsErrorItemsTask, optional)
- `type` (enum, optional)
  - Allowed values: `standard`, `revert`, `loop`

### OperationsManagerJobApiTasksErrorHandlerGroupsItems1

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `name` (string, optional)
- `description` (string, optional)
- `memberOf` (list of OperationsManagerJobApiTasksErrorHandlerGroupsItemsOneOf1MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiTasksErrorHandlerGroupsItemsOneOf1AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `_meta` (OperationsManagerJobApiTasksErrorHandlerGroupsItemsOneOf1Meta, optional)

### OperationsManagerJobApiErrorHandlerGroupsItemsOneOf1MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiErrorHandlerGroupsItemsOneOf1AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiErrorHandlerGroupsItemsOneOf1Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiMetricsUserOneOf2MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiMetricsUserOneOf2AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiMetricsUserOneOf2Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiMetricsOwnerOneOf2MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiMetricsOwnerOneOf2AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiMetricsOwnerOneOf2Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiTasksWorkflowStartMetricsUser2

- `_id` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `provenance` (string, optional)
- `username` (string, optional)
- `firstname` (string, optional)
- `memberOf` (list of OperationsManagerJobApiTasksWorkflowStartMetricsUserOneOf2MemberOfItems, optional)
- `assignedRoles` (list of OperationsManagerJobApiTasksWorkflowStartMetricsUserOneOf2AssignedRolesItems, optional)
- `inactive` (boolean, optional)
- `lastLogin` (string, optional) — An ISO 8601 date string
- `_meta` (OperationsManagerJobApiTasksWorkflowStartMetricsUserOneOf2Meta, optional)
- `email` (string, optional)

### OperationsManagerJobApiTasksWorkflowStartGroupsItemsOneOf1MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiTasksWorkflowStartGroupsItemsOneOf1AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiTasksWorkflowStartGroupsItemsOneOf1Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiTasksWorkflowEndGroupsItemsOneOf1MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiTasksWorkflowEndGroupsItemsOneOf1AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiTasksWorkflowEndGroupsItemsOneOf1Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiTasksErrorHandlerTransitionsSuccessItemsTask

### OperationsManagerJobApiTasksErrorHandlerTransitionsFailureItemsTask

### OperationsManagerJobApiTasksErrorHandlerTransitionsErrorItemsTask

### OperationsManagerJobApiTasksErrorHandlerGroupsItemsOneOf1MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiTasksErrorHandlerGroupsItemsOneOf1AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiTasksErrorHandlerGroupsItemsOneOf1Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

### OperationsManagerJobApiTasksWorkflowStartMetricsUserOneOf2MemberOfItems

- `groupId` (string, optional) — A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `aaaManaged` (boolean, optional)

### OperationsManagerJobApiTasksWorkflowStartMetricsUserOneOf2AssignedRolesItems

- `roleId` (string, optional)

### OperationsManagerJobApiTasksWorkflowStartMetricsUserOneOf2Meta

- `created` (string, optional) — An ISO 8601 date string
- `updated` (string, optional) — An ISO 8601 date string
- `migrationVersion` (integer, optional) — The current document version of this document.

## Examples

**Response**

```json
{
  "message": "Successfully created the requested item",
  "data": {
    "_id": "string",
    "uuid": "string",
    "font_size": 12,
    "type": "automation",
    "created": "2024-01-15T09:30:00Z",
    "last_updated": "2024-01-15T09:30:00Z",
    "createdVersion": "5.55.5",
    "lastUpdatedVersion": "5.55.6",
    "canvasVersion": 1,
    "encodingVersion": 1,
    "migrationVersion": 1,
    "name": "Cisco IOS upgrade",
    "description": "Turn up the port",
    "preAutomationTime": 0,
    "sla": 0,
    "decorators": [
      {
        "type": null,
        "pointer": "string"
      }
    ],
    "transitions": {},
    "status": "error",
    "variables": {
      "_id": {
        "_id": "67be20c2dda0df69ebe60825",
        "location": "job_data"
      },
      "initiator": {
        "_id": "67be20c2dda0df69ebe60826",
        "location": "job_data"
      }
    },
    "tags": [
      "string"
    ],
    "error": [
      {
        "task": null,
        "message": {},
        "timestamp": 1.1
      }
    ],
    "warnings": [
      {
        "task": "workflow_start",
        "name": "Cisco IOS upgrade",
        "message": {}
      }
    ],
    "ancestors": [
      "string"
    ],
    "validationErrors": [
      {
        "keyword": "string",
        "instancePath": "string",
        "schemaPath": "string",
        "params": {},
        "message": "string"
      }
    ],
    "namespace": {},
    "mocked": true,
    "created_by": null,
    "last_updated_by": null,
    "tasks": {
      "workflow_start": {
        "x": 1.1,
        "y": 1.1,
        "gridCoordinate": {
          "x": 1.1,
          "y": 1.1
        },
        "name": null,
        "summary": null,
        "taskId": null,
        "metrics": {
          "user": null
        },
        "groups": [
          "string"
        ],
        "iterations": [
          {}
        ]
      },
      "workflow_end": {
        "x": 1.1,
        "y": 1.1,
        "gridCoordinate": {
          "x": 1.1,
          "y": 1.1
        },
        "name": null,
        "summary": null,
        "taskId": null,
        "endTasks": {
          "incomplete": [
            "workflow_start"
          ],
          "complete": [
            "workflow_start"
          ],
          "error": [
            "workflow_start"
          ]
        },
        "metrics": {
          "end_time": 1.1,
          "run_time": 1.1
        },
        "groups": [
          "string"
        ],
        "iterations": [
          {}
        ]
      },
      "error_handler": {
        "x": 1.1,
        "y": 1.1,
        "gridCoordinate": {
          "x": 1.1,
          "y": 1.1
        },
        "name": "string",
        "location": "Adapter",
        "locationType": "string",
        "app": "string",
        "canvasName": "string",
        "displayName": "string",
        "summary": "string",
        "description": "string",
        "variables": {
          "incoming": {},
          "outgoing": {},
          "error": "string",
          "decorators": [
            {
              "type": null,
              "pointer": "string"
            }
          ]
        },
        "deprecated": true,
        "scheduled": true,
        "matched": [
          {
            "key": "string",
            "highlightString": "string"
          }
        ],
        "status": "incomplete",
        "previous": {
          "incomplete": [
            "workflow_start"
          ],
          "complete": [
            "workflow_start"
          ],
          "error": [
            "workflow_start"
          ]
        },
        "taskId": "workflow_start",
        "transitions": {
          "success": [
            {
              "task": "workflow_start",
              "type": "standard"
            }
          ],
          "failure": [
            {
              "task": "workflow_start",
              "type": "standard"
            }
          ],
          "error": [
            {
              "task": "workflow_start",
              "type": "standard"
            }
          ]
        },
        "serverId": "string",
        "start_time": "2024-01-15T09:30:00Z",
        "end_time": 1.1,
        "finish_state": "success",
        "retrySettings": null,
        "mockId": "string",
        "type": null,
        "actor": null,
        "groups": [
          "string"
        ],
        "iterations": [
          {}
        ]
      }
    },
    "parent": {
      "job": "fe7043ac41d24206aa556c49",
      "task": "defc",
      "iteration": 1,
      "element": 0
    },
    "errorHandler": null,
    "groups": [
      "string"
    ],
    "watchers": [
      null
    ],
    "metrics": {
      "start_time": 1.1,
      "progress": 0.5,
      "end_time": 1.1,
      "user": null,
      "owner": null
    },
    "output": {},
    "outputData": {}
  },
  "metadata": {}
}
```

**SDK Code**

```python
import requests

url = "https://example.itential.io/operations-manager/jobs/id"

querystring = {"dereference":"tasks","exclude":"_id","include":"name"}

response = requests.get(url, params=querystring)

print(response.json())
```

```javascript
const url = 'https://example.itential.io/operations-manager/jobs/id?dereference=tasks&exclude=_id&include=name';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://example.itential.io/operations-manager/jobs/id?dereference=tasks&exclude=_id&include=name"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://example.itential.io/operations-manager/jobs/id?dereference=tasks&exclude=_id&include=name")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://example.itential.io/operations-manager/jobs/id?dereference=tasks&exclude=_id&include=name")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://example.itential.io/operations-manager/jobs/id?dereference=tasks&exclude=_id&include=name');

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://example.itential.io/operations-manager/jobs/id?dereference=tasks&exclude=_id&include=name");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let request = NSMutableURLRequest(url: NSURL(string: "https://example.itential.io/operations-manager/jobs/id?dereference=tasks&exclude=_id&include=name")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```