---
title: "POST /api/v1/job-instances/download"
method: POST
path: "/api/v1/job-instances/download"
tags: ["job-instance-controller"]
---

# POST /api/v1/job-instances/download

`POST /api/v1/job-instances/download`

## Request

- Base URL: `https://api-docs.gosure.ai`
- URL: `https://api-docs.gosure.ai/api/v1/job-instances/download`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gosure/apis/gosure-api/docs/api/v1/job-instances/download/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- DownloadJobInstanceRequest
  - `jobTypeName` string
  - `filters` JobInstanceFilterData[]
    - `fieldName` string
    - `condition` string
    - `value` unknown
    - `betweenRange` unknown
    - `logicalOperator` string
    - `fromMetadata` boolean
  - `requiredFields` string[]
  - `includeSubJobs` boolean
  - `xlsxDownloadRequest` boolean
  - `isDownloadTargetFieldsMis` boolean
  - `triggeredFromScheduler` boolean
  - `configurationJobInstanceId` string
  - `downloadType` string

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request

## Changes

- **2026-08-29** `9db94ab09bfb`: 1 info
  - added the new optional request property `downloadType`

[Operation history](https://skmtc.dev/gosure/apis/gosure-api/changes/api/v1/job-instances/download/post.md)

---

[API](https://skmtc.dev/gosure/apis/gosure-api.md) - [All operations](https://skmtc.dev/gosure/apis/gosure-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gosure/apis/gosure-api/revisions/854c83fbb507?raw)