---
title: "POST /applications/{applicationId}/batch-job"
method: POST
path: "/applications/{applicationId}/batch-job"
---

# POST /applications/{applicationId}/batch-job

`POST /applications/{applicationId}/batch-job`

Starts a batch job and returns the unique identifier of this execution of the batch job. The associated application must be running in order to start the batch job.

## Path parameters

- `applicationId` string, required

## Request body

- object
  - `authSecretsManagerArn` string — The Amazon Web Services Secrets Manager containing user's credentials for authentication and authorization for Start Batch Job execution operation.
  - `batchJobIdentifier` object, required — Identifies a specific batch job.
    - `fileBatchJobIdentifier` object — Specifies a file associated with a specific batch job.
      - `fileName` string, required — The file name for the batch job identifier.
      - `folderPath` string — The relative path to the file name for the batch job identifier.
    - `restartBatchJobIdentifier` object — Specifies the required information for restart, including <code>executionId</code> and <code>JobStepRestartMarker</code>.
      - `executionId` string, required — The <code>executionId</code> from the <code>StartBatchJob</code> response when the job ran for the first time.
      - `jobStepRestartMarker` object, required — The step/procedure step information for a restart batch job operation.
        - `fromProcStep` string — The procedure step name that a batch job was restarted from.
        - `fromStep` string, required — The step name that a batch job was restarted from.
        - `skip` boolean — The step-level checkpoint timestamp (creation or last modification) for an Amazon Web Services Blu Age application batch job.
        - `stepCheckpoint` integer — Skip selected step and issue a restart from immediate successor step for an Amazon Web Services Blu Age application batch job.
        - `toProcStep` string — The procedure step name that a batch job was restarted to.
        - `toStep` string — The step name that a batch job was restarted to.
    - `s3BatchJobIdentifier` object — Specifies an Amazon S3 location that identifies the batch jobs that you want to run. Use this identifier to run ad hoc batch jobs.
      - `bucket` string, required — The Amazon S3 bucket that contains the batch job definitions.
      - `identifier` object, required — Identifies the batch job definition. This identifier can also point to any batch job definition that already exists in the application or to one of the batch job definitions within the directory that is specified in <code>keyPrefix</code>.
        - `fileName` string — The name of the file that contains the batch job definition.
        - `scriptName` string — The name of the script that contains the batch job definition.
      - `keyPrefix` string — The key prefix that specifies the path to the folder in the S3 bucket that has the batch job definitions.
    - `scriptBatchJobIdentifier` object — A batch job identifier in which the batch job to run is identified by the script name.
      - `scriptName` string, required — The name of the script containing the batch job definition.
  - `jobParams` object — Job parameters are optional. Can contain up to 500 entries.

## Response `200`

Success

- StartBatchJobResponse
  - `executionId` string, required — The unique identifier of this execution of the batch job.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ThrottlingException
- `482` — AccessDeniedException
- `483` — ConflictException
- `484` — ValidationException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/m2.md) · [All operations](https://skmtc.net/aws/apis/m2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/m2/versions/aac43e95a42b/schema)