---
title: "Get task details"
method: GET
path: "/workflow_builder/getTaskDetails/{app}/{task}"
tags: ["Workflow Builder"]
---

# Get task details

`GET /workflow_builder/getTaskDetails/{app}/{task}`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/workflow_builder/getTaskDetails/{app}/{task}`
- Auth: none declared

Returns a Task's details.

## Path parameters

- `app` string, required
- `task` string, required

## Response `200`

Detailed Task.

- union
  - WorkflowBuilderWorkflowDocumentAnyTask0
    - `nodeLocation` WorkflowBuilderWorkflowDocumentAnyTaskOneOf0NodeLocation: Stores the coordinates used by canvasVersion: 3 workflows
      - `x` number, double, required
      - `y` number, double, required
    - `x` number, double
    - `y` number, double
    - `name` string, required
    - `summary` string, required
    - `description` string, required
    - `app` string, required
    - `variables` WorkflowBuilderWorkflowDocumentAnyTaskOneOf0Variables, required
      - `incoming` WorkflowBuilderWorkflowDocumentAnyTaskOneOf0VariablesIncoming, required
      - `outgoing` WorkflowBuilderWorkflowDocumentAnyTaskOneOf0VariablesOutgoing, required
      - `error` string
      - `decorators` WorkflowBuilderWorkflowDocumentAnyTaskOneOf0VariablesDecoratorsItems[]
        - `type` 'encryption'
        - `pointer` string, json-pointer
    - `deprecated` boolean
    - `scheduled` boolean
    - `groups` string[], required
    - `type` 'manual', required
    - `view` string, required
  - WorkflowBuilderWorkflowDocumentAnyTask1
    - `nodeLocation` WorkflowBuilderWorkflowDocumentAnyTaskOneOf1NodeLocation: Stores the coordinates used by canvasVersion: 3 workflows
      - `x` number, double, required
      - `y` number, double, required
    - `x` number, double
    - `y` number, double
    - `name` string, required
    - `summary` string, required
    - `description` string, required
    - `app` string, required
    - `variables` WorkflowBuilderWorkflowDocumentAnyTaskOneOf1Variables, required
      - `incoming` WorkflowBuilderWorkflowDocumentAnyTaskOneOf1VariablesIncoming, required
      - `outgoing` WorkflowBuilderWorkflowDocumentAnyTaskOneOf1VariablesOutgoing, required
      - `error` string
      - `decorators` WorkflowBuilderWorkflowDocumentAnyTaskOneOf1VariablesDecoratorsItems[]
        - `type` 'encryption'
        - `pointer` string, json-pointer
    - `deprecated` boolean
    - `scheduled` boolean
    - `groups` string[], required
    - `type` 'automatic', required
    - `actor` string, required
    - `retrySettings` WorkflowBuilderWorkflowDocumentAnyTaskOneOf1RetrySettings: Retry settings for a task.
      - `state` WorkflowBuilderWorkflowDocumentAnyTaskOneOf1RetrySettingsStateItems[], required: Finish states the task will retry on. The task will retry on any of the included states.
      - `autoRetry` boolean, required: Whether the task is set to retry automatically or manually.
      - `limit` integer, required: Limit of retries on a task before it will take normal transitions and stop retrying.
      - `delay` integer, required: Delay between each retry in milliseconds.
      - `count` integer: Current retry count used for workflow engine job processing
  - WorkflowBuilderWorkflowDocumentAnyTask2
    - `nodeLocation` WorkflowBuilderWorkflowDocumentAnyTaskOneOf2NodeLocation: Stores the coordinates used by canvasVersion: 3 workflows
      - `x` number, double, required
      - `y` number, double, required
    - `x` number, double
    - `y` number, double
    - `name` string, required
    - `summary` string, required
    - `description` string, required
    - `app` string, required
    - `variables` WorkflowBuilderWorkflowDocumentAnyTaskOneOf2Variables, required
      - `incoming` WorkflowBuilderWorkflowDocumentAnyTaskOneOf2VariablesIncoming, required
      - `outgoing` WorkflowBuilderWorkflowDocumentAnyTaskOneOf2VariablesOutgoing, required
      - `error` string
      - `decorators` WorkflowBuilderWorkflowDocumentAnyTaskOneOf2VariablesDecoratorsItems[]
        - `type` 'encryption'
        - `pointer` string, json-pointer
    - `deprecated` boolean
    - `scheduled` boolean
    - `groups` string[], required
    - `type` 'operation', required
    - `retrySettings` WorkflowBuilderWorkflowDocumentAnyTaskOneOf2RetrySettings: Retry settings for a task.
      - `state` WorkflowBuilderWorkflowDocumentAnyTaskOneOf2RetrySettingsStateItems[], required: Finish states the task will retry on. The task will retry on any of the included states.
      - `autoRetry` boolean, required: Whether the task is set to retry automatically or manually.
      - `limit` integer, required: Limit of retries on a task before it will take normal transitions and stop retrying.
      - `delay` integer, required: Delay between each retry in milliseconds.
      - `count` integer: Current retry count used for workflow engine job processing

## Other responses

- `500`: Error response from API

## Changes

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

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