---
title: "Promote Application by items"
method: POST
path: "/promote/applicationByItems"
tags: ["Promotions"]
---

# Promote Application by items

`POST /promote/applicationByItems`

## Request

- Base URL: `https://env.unqork.io/api/1.0`
- URL: `https://env.unqork.io/api/1.0/promote/applicationByItems`
- Auth: OAuth 2
  - Client credentials
  - Password
  - Token URL: `https://xyzfinancial.unqork.io/api/1.0/oauth2/access_token`
- TypeScript: <https://skmtc.dev/unqork/apis/unqork-customer-api/docs/promote/applicationByItems/post.ts> (a function with typed inputs; its response is checked against the schema)

Promote a specific application with Modules, Workflows, Data Schemas, Data Collections, Module Archives, or Workflow Archives
### Authorization Required:
  - Application Promote

## Request body

- PromotionApplicationByItemExecuteRequest
  - `clientName` string, required: Target environment name
  - `clientLevel` string, required: Level of the environment (qa, uat, production, etc.)
  - `applicationId` string, required: applicationId of the application to promote
  - `modules` string[]: Array of Modules to Promote
  - `referenceDataCollections` string[]: Array of Reference Data Collections to Promote
  - `moduleArchives` object[]: Array of Module Archives to Promote. Must include the moduleId
    - `moduleId` string, required: ID of the Module whose archive needs to be promoted
    - `archiveId` string, required: Archive Id of the Module
  - `workflowArchives` string[]: Array of Workflow Archives to Promote
  - `workflows` string[]: Array of Workflows to Promote
  - `dataSchemaIds` string[]: Array of Data Schemas to Promote
  - `dataModels` string[]: Array of Data Models to Promote
  - `schemas` string[]: Array of Data Model Schemas to Promote
  - `searchConfigs` string[]: Array of Queries to Promote

## Response `200`

Job Execution Initiated.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/unqork/apis/unqork-customer-api.md) - [All operations](https://skmtc.dev/unqork/apis/unqork-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unqork/apis/unqork-customer-api/revisions/13dad4096373?raw)