---
title: "Query data using 'json-query' format"
method: POST
path: "/workflow_engine/query"
tags: ["Workflow Engine"]
---

# Query data using 'json-query' format

`POST /workflow_engine/query`

## Request

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

Query data using a dot/bracket notation string and a matching key/value pair.

## Request body

- object
  - `job_id` string: String representation of a MongoDB ObjectId
  - `pass_on_null` boolean
  - `query` string
  - `obj` WorkflowEngineQueryPostRequestBodyContentApplicationJsonSchemaObj

## Response `200`

Returned data from the match query

- union
  - string
  - number, double
  - object
  - unknown[]
    - unknown
  - boolean

## 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/query/post.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)
