---
title: "POST /syncDeploymentJob"
method: POST
path: "/syncDeploymentJob"
deprecated: true
---

# POST /syncDeploymentJob

`POST /syncDeploymentJob`

> **Deprecated.**

Syncrhonizes robots in a fleet to the latest deployment. This is helpful if robots were added after a deployment.

This API will no longer be supported as of May 2, 2022. Use it to remove resources that were created for Deployment Service.

## Request body

- object
  - `clientRequestToken` string, required — Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
  - `fleet` string, required — The target fleet for the synchronization.

## Response `200`

Success

- SyncDeploymentJobResponse — Support for the AWS RoboMaker application deployment feature has ended. For additional information, see https://docs.aws.amazon.com/robomaker/latest/dg/fleets.html.
  - `arn` string — The Amazon Resource Name (ARN) of the synchronization request.
  - `fleet` string — The Amazon Resource Name (ARN) of the fleet.
  - `status` 'Pending' | 'Preparing' | 'InProgress' | 'Failed' | 'Succeeded' | 'Canceled' — The status of the synchronization job.
  - `deploymentConfig` object — Information about the deployment configuration.
    - `concurrentDeploymentPercentage` integer — The percentage of robots receiving the deployment at the same time.
    - `failureThresholdPercentage` integer — The percentage of deployments that need to fail before stopping deployment.
    - `robotDeploymentTimeoutInSeconds` integer — The amount of time, in seconds, to wait for deployment to a single robot to complete. Choose a time between 1 minute and 7 days. The default is 5 hours.
    - `downloadConditionFile` object — The download condition file.
      - `bucket` string, required — The bucket containing the object.
      - `key` string, required — The key of the object.
      - `etag` string — The etag of the object.
  - `deploymentApplicationConfigs` DeploymentApplicationConfig[] — Information about the deployment application configurations.
    - `application` string, required — The Amazon Resource Name (ARN) of the robot application.
    - `applicationVersion` string, required — The version of the application.
    - `launchConfig` object, required — The launch configuration.
      - `packageName` string, required — The package name.
      - `preLaunchFile` string — The deployment pre-launch file. This file will be executed prior to the launch file.
      - `launchFile` string, required — The launch file name.
      - `postLaunchFile` string — The deployment post-launch file. This file will be executed after the launch file.
      - `environmentVariables` object — An array of key/value pairs specifying environment variables for the robot application
  - `failureReason` string — The failure reason if the job fails.
  - `failureCode` 'ResourceNotFound' | 'EnvironmentSetupError' | 'EtagMismatch' | 'FailureThresholdBreached' | 'RobotDeploymentAborted' | 'RobotDeploymentNoResponse' | 'RobotAgentConnectionTimeout' | 'GreengrassDeploymentFailed' | 'InvalidGreengrassGroup' | 'MissingRobotArchitecture' | 'MissingRobotApplicationArchitecture' | 'MissingRobotDeploymentResource' | 'GreengrassGroupVersionDoesNotExist' | 'LambdaDeleted' | 'ExtractingBundleFailure' | 'PreLaunchFileFailure' | 'PostLaunchFileFailure' | 'BadPermissionError' | 'DownloadConditionFailed' | 'BadLambdaAssociated' | 'InternalServerError' | 'RobotApplicationDoesNotExist' | 'DeploymentFleetDoesNotExist' | 'FleetDeploymentTimeout' — <p>The failure code if the job fails:</p> <dl> <dt>InternalServiceError</dt> <dd> <p>Internal service error.</p> </dd> <dt>RobotApplicationCrash</dt> <dd> <p>Robot application exited abnormally.</p> </dd> <dt>SimulationApplicationCrash</dt> <dd> <p> Simulation application exited abnormally.</p> </dd> <dt>BadPermissionsRobotApplication</dt> <dd> <p>Robot application bundle could not be downloaded.</p> </dd> <dt>BadPermissionsSimulationApplication</dt> <dd> <p>Simulation application bundle could not be downloaded.</p> </dd> <dt>BadPermissionsS3Output</dt> <dd> <p>Unable to publish outputs to customer-provided S3 bucket.</p> </dd> <dt>BadPermissionsCloudwatchLogs</dt> <dd> <p>Unable to publish logs to customer-provided CloudWatch Logs resource.</p> </dd> <dt>SubnetIpLimitExceeded</dt> <dd> <p>Subnet IP limit exceeded.</p> </dd> <dt>ENILimitExceeded</dt> <dd> <p>ENI limit exceeded.</p> </dd> <dt>BadPermissionsUserCredentials</dt> <dd> <p>Unable to use the Role provided.</p> </dd> <dt>InvalidBundleRobotApplication</dt> <dd> <p>Robot bundle cannot be extracted (invalid format, bundling error, or other issue).</p> </dd> <dt>InvalidBundleSimulationApplication</dt> <dd> <p>Simulation bundle cannot be extracted (invalid format, bundling error, or other issue).</p> </dd> <dt>RobotApplicationVersionMismatchedEtag</dt> <dd> <p>Etag for RobotApplication does not match value during version creation.</p> </dd> <dt>SimulationApplicationVersionMismatchedEtag</dt> <dd> <p>Etag for SimulationApplication does not match value during version creation.</p> </dd> </dl>
  - `createdAt` string, date-time — The time, in milliseconds since the epoch, when the fleet was created.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InvalidParameterException
- `482` — InternalServerException
- `483` — ThrottlingException
- `484` — LimitExceededException
- `485` — ConcurrentDeploymentException
- `486` — IdempotentParameterMismatchException

---

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