---
title: "Search task mocks"
method: GET
path: "/workflow_engine/mocks/tasks"
tags: ["Workflow Engine"]
---

# Search task mocks

`GET /workflow_engine/mocks/tasks`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/workflow_engine/mocks/tasks`
- Auth: none declared

Searches for mocks based on query parameters.

## Query parameters

- `name` string
- `ids` string
- `serviceType` 'Application' | 'Adapter': Filter mocks by service type
- `serviceName` string
- `method` string
- `finishState` 'success' | 'failure' | 'error': Filter mocks by finish state
- `createdBy` string
- `skip` integer
- `limit` integer
- `includeResponse` boolean

## Response `200`

Search results containing an array of task mocks

- WorkflowEngineSearchMocksResponse200
  - `results` WorkflowEngineTaskMockResponse[]
    - `_id` string, uuid, required: The unique identifier for the mock task
    - `name` string, required: The name of the mock task
    - `description` string, required: A description of the mock task
    - `serviceType` 'Application' | 'Adapter', required: Whether or not the mock is for an adapter or application service
    - `serviceName` string, required: The adapter or application service name that contains the method to mock
    - `method` string, required: The name of the method that is being mocked
    - `finishState` 'success' | 'failure' | 'error', required: The finish state of the mock
    - `delay` integer, required: The number of seconds to delay the completion of the mock
    - `response` union, required: The response for the mock that matches the return value for the task method
      - unknown[]
        - unknown
      - boolean
      - integer
      - number, double
      - object
      - string
    - `created` string, date-time, required: The date and time when the mock was created
    - `createdBy` string, required: The id of user who created the mock task
    - `lastUpdated` string, date-time: The date and time when the mock was last updated
    - `lastUpdatedBy` string: The id of user who last updated the mock task
  - `skip` integer: The number of documents skipped before returning data. When 0, no data is skipped.
  - `limit` integer: Specifies a limit to the maximum number of data results returned.
  - `total` integer: The total number of documents returned from a search.

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Workflow Engine` added
  - api tag `workflowEngine` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/workflow_engine/mocks/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)