---
title: "Retrieve task schema"
method: POST
path: "/journey/task/schema"
---

# Retrieve task schema

`POST /journey/task/schema`

Fetch the schema for a specific task to see the required fields and expected data structure. This schema defines the format of data required to complete the task.

## Request body

- object
  - `taskId` string, required — Unique identifier for the task assigned to the customer.

## Response `201`

Schema retrieved successfully.

- object
  - `$schema` string, required — The JSON Schema version of the schema.
  - `type` string, required — The type of the schema.
  - `properties` object, required — An object containing the properties of the schema.
  - `required` string[], required — An array of the required properties of the schema.

---

[API](https://skmtc.net/gbgplc/apis/gbg-go-api-reference.md) · [All operations](https://skmtc.net/gbgplc/apis/gbg-go-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gbgplc/gbg-go-api-reference/versions/71fc8231d3fb/schema)