---
title: "Get Task Type"
method: GET
path: "/task-types/{taskTypeId}"
tags: ["Task Type"]
---

# Get Task Type

`GET /task-types/{taskTypeId}`

Retrieves a task type by identifier.

## Query parameters

- `fields` string

## Headers

- `Authorization` string, required
- `X-LC-Tenant` string, required

## Response `200`

- TaskType — Task type.
  - `id` string, required
  - `key` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">Identifier key for the task.</div>
  - `name` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;"></div>
  - `apiInternalId` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;"> Unique identifier of custom task types set in the workflow. If no custom id is set, it will return the default identifier for the custom task type.
  - `description` string
  - `automatic` boolean, nullable — This indicates whether the task is automatic or human.
  - `scope` 'file' | 'targetLanguage' | 'batch' | 'vendorOrder' | 'task', nullable — The resource type scope for the task.
  - `outcomes` TaskTypeOutcome[]
    - `name` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;"></div>
    - `description` string
    - `default` boolean, nullable — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;"></div>
  - `configurationDefinitions` TaskTypeConfigurationDefinition[] — Defines the configurable options available for this task type. Each entry describes one configuration option including its data type, default value, allowed values and constraints.
    - `id` string, required — The identifier for the configuration option (e.g. `FORCE_CLOSE_MAX_AGE`).
    - `name` string, required — Human-readable name for the configuration option.
    - `description` string — Explanation of what this configuration option controls.
    - `dataType` 'integer' | 'boolean' | 'string', required — The data type of the configuration value.
    - `optional` boolean, required — Whether this configuration option is optional. If `false`, a value must always be supplied.
    - `defaultValue` object, nullable — The default value applied when no value is explicitly set. The type matches `dataType`. May be `null` when no default is defined.
    - `options` string[], nullable — Enumerated list of accepted string values. Present only when `dataType` is `string` and the value is restricted to a fixed set. `null` when any value is allowed.
    - `constraints` TaskTypeConfigurationConstraint[] — Validation constraints applied to the value (e.g. minimum/maximum for numeric types).
      - `type` 'minValue' | 'maxValue', required — The kind of constraint.
      - `value` object, required — The constraint threshold. Type matches the parent configuration option's `dataType`.
  - `location` FolderV2 — Folder used for resource storage.
    - `id` string, required — The folder identifier.
    - `name` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The name of the folder.</div>
    - `hasParent` boolean, nullable — Indicates if the folder has a parent folder.
    - `path` FolderPath[] — The hierarchical path. It consists of all the items of the path in reverse order, the parent of the current folder being the first in the list, and the root of the account being the last.
      - `id` string, required — The folder identifier.
      - `name` string, required — The name of the folder.
      - `location` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div>The location identifier.
      - `hasParent` boolean, nullable — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div>Indicates if the folder has a parent folder.

## Other responses

- `400` — Error codes: * “invalid”: Invalid input in the query parameter mentioned in the “name” field on the error response.
- `401` — The user could not be identified.
- `403` — Error codes: * "forbidden": the authenticated user is not allowed to read the task type.
- `404` — Error codes: * "notFound": the resource could not be found by identifier.

## Changes

- **2026-06-22** (v1) `4541da7dca36` — 1 info
  - added the optional property `configurationDefinitions` to the response with the `200` status
- **2026-06-22** (v1) `ad07690afdcd` — 1 warning
  - removed the optional property `configurationDefinitions` from the response with the `200` status
- **2026-06-22** (v1) `501ab2689d6a` — 1 info
  - added the optional property `configurationDefinitions` to the response with the `200` status
- **2026-06-02** (v1) `65a907432d79` — 1 warning
  - removed the optional property `configurationDefinitions` from the response with the `200` status
- **2026-05-26** (v1) `ef863b3229e2` — 1 info
  - added the optional property `configurationDefinitions` to the response with the `200` status

[Full history](https://skmtc.dev/rws/apis/trados-cloud-platform-api/changes/task-types/:taskTypeId/get.md)

---

[API](https://skmtc.dev/rws/apis/trados-cloud-platform-api.md) · [All operations](https://skmtc.dev/rws/apis/trados-cloud-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rws/trados-cloud-platform-api/revisions/d42dac7c28a3/schema)