---
title: "Get tasks"
method: GET
path: "/operations-manager/tasks"
tags: ["Operations Manager"]
---

# Get tasks

`GET /operations-manager/tasks`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/operations-manager/tasks`
- Auth: none declared

Searches the Task collection.

## Query parameters

- `limit` integer
- `skip` integer
- `order` '-1' | '1': Sort direction, 1 for ascending and -1 for descending.
- `sort` 'name': Field to sort by
- `include` string
- `exclude` string
- `in` string
- `not-in` string
- `equals` string
- `contains` string
- `starts-with` string
- `ends-with` string
- `dereference` string
- `gt` string
- `gte` string
- `lt` string
- `lte` string
- `q` string
- `actionableTasks` boolean

## Response `200`

The Tasks that matched the search query.

- OperationsManagerGetTasksResponse200: A success response from an API method
  - `message` string, required: A human-readable message summarizing the result of the operation
  - `data` OperationsManagerTaskApi[], required: Any successfully retrieved information related to the request.
    - `_id` string: A UUIDv4 identifier.
    - `location` 'Adapter' | 'Application' | 'Broker'
    - `view` string, nullable
    - `status` 'incomplete' | 'scheduled' | 'running' | 'complete' | 'canceled' | 'error' | 'failure' | 'paused'
    - `app` string
    - `name` string
    - `variables` OperationsManagerTaskApiVariables
      - `incoming` OperationsManagerTaskApiVariablesIncoming
      - `outgoing` OperationsManagerTaskApiVariablesOutgoing
      - `decorators` OperationsManagerTaskApiVariablesDecoratorsItems[]
        - `type` unknown
        - `pointer` string, json-pointer
    - `last_updated` string, date-time: An ISO 8601 date string
    - `encodingVersion` '1'
    - `job` OperationsManagerTaskApiJob
      - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
      - `task` string
      - `name` string: The name of the document
      - `description` string, nullable
      - `ancestors` string[], nullable
    - `incomingRefs` unknown[]
      - unknown
    - `workItemId` string: A UUIDv7 identifier.
    - `mockId` string: A UUIDv4 identifier.
    - `externalRef` OperationsManagerTaskApiExternalRef
      - `type` 'agentSession'
      - `id` string
    - `groups` OperationsManagerTaskApiGroupsItems[]
      - union
        - OperationsManagerTaskApiGroupsItems0
          - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
          - `provenance` string
          - `name` string
          - `description` string
          - `memberOf` OperationsManagerTaskApiGroupsItemsOneOf0MemberOfItems[]
            - `groupId` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
            - `aaaManaged` boolean
          - `assignedRoles` OperationsManagerTaskApiGroupsItemsOneOf0AssignedRolesItems[]
            - `roleId` string
          - `inactive` boolean
          - `_meta` OperationsManagerTaskApiGroupsItemsOneOf0Meta
            - `created` string, date-time: An ISO 8601 date string
            - `updated` string, date-time: An ISO 8601 date string
            - `migrationVersion` integer: The current document version of this document.
        - string
    - `type` unknown
    - `metrics` OperationsManagerTaskApiOneOfMetrics
      - `start_time` string
      - `claim_time` string, date-time: An ISO 8601 date string
      - `end_time` number, double
      - `server_id` string
      - `finish_state` union
        - unknown
        - 'incomplete' | 'scheduled' | 'running' | 'complete' | 'canceled' | 'error' | 'failure' | 'paused'
      - `run_time` number, double
      - `user` union
        - OperationsManagerTaskApiOneOfMetricsUser0
          - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
          - `provenance` string
          - `username` string
          - `firstname` string
          - `memberOf` OperationsManagerTaskApiOneOfMetricsUserOneOf0MemberOfItems[]
            - `groupId` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
            - `aaaManaged` boolean
          - `assignedRoles` OperationsManagerTaskApiOneOfMetricsUserOneOf0AssignedRolesItems[]
            - `roleId` string
          - `inactive` boolean
          - `lastLogin` string, date-time: An ISO 8601 date string
          - `_meta` OperationsManagerTaskApiOneOfMetricsUserOneOf0Meta
            - `created` string, date-time: An ISO 8601 date string
            - `updated` string, date-time: An ISO 8601 date string
            - `migrationVersion` integer: The current document version of this document.
          - `email` string
        - string
        - '' | 'Pronghorn'
      - `owner` union
        - OperationsManagerTaskApiOneOfMetricsOwner0
          - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
          - `provenance` string
          - `username` string
          - `firstname` string
          - `memberOf` OperationsManagerTaskApiOneOfMetricsOwnerOneOf0MemberOfItems[]
            - `groupId` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
            - `aaaManaged` boolean
          - `assignedRoles` OperationsManagerTaskApiOneOfMetricsOwnerOneOf0AssignedRolesItems[]
            - `roleId` string
          - `inactive` boolean
          - `lastLogin` string, date-time: An ISO 8601 date string
          - `_meta` OperationsManagerTaskApiOneOfMetricsOwnerOneOf0Meta
            - `created` string, date-time: An ISO 8601 date string
            - `updated` string, date-time: An ISO 8601 date string
            - `migrationVersion` integer: The current document version of this document.
          - `email` string
        - string
        - '' | 'Pronghorn'
  - `metadata` OperationsManagerCommonApiPaginationMetadata, required: Properties describing search result pagination
    - `skip` integer
    - `limit` integer
    - `total` integer
    - `nextPageSkip` integer, nullable
    - `previousPageSkip` integer, nullable
    - `currentPageSize` integer

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Operations Manager` added
  - api tag `operationsManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/operations-manager/tasks/get.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)