---
title: "POST /createSimulationApplicationVersion"
method: POST
path: "/createSimulationApplicationVersion"
---

# POST /createSimulationApplicationVersion

`POST /createSimulationApplicationVersion`

Creates a simulation application with a specific revision id.

## Request body

- object
  - `application` string, required — The application information for the simulation application.
  - `currentRevisionId` string — The current revision id for the simulation application. If you provide a value and it matches the latest revision ID, a new version will be created.
  - `s3Etags` S3Etag[] — The Amazon S3 eTag identifier for the zip file bundle that you use to create the simulation application.
  - `imageDigest` string — The SHA256 digest used to identify the Docker image URI used to created the simulation application.

## Response `200`

Success

- CreateSimulationApplicationVersionResponse
  - `arn` string — The Amazon Resource Name (ARN) of the simulation application.
  - `name` string — The name of the simulation application.
  - `version` string — The version of the simulation application.
  - `sources` Source[] — The sources of the simulation application.
    - `s3Bucket` string — The s3 bucket name.
    - `s3Key` string — The s3 object key.
    - `etag` string — A hash of the object specified by <code>s3Bucket</code> and <code>s3Key</code>.
    - `architecture` 'X86_64' | 'ARM64' | 'ARMHF' — The taget processor architecture for the application.
  - `simulationSoftwareSuite` object — The simulation software suite used by the simulation application.
    - `name` 'Gazebo' | 'RosbagPlay' | 'SimulationRuntime' — The name of the simulation software suite.
    - `version` string — The version of the simulation software suite.
  - `robotSoftwareSuite` object — Information about the robot software suite (ROS distribution).
    - `name` 'ROS' | 'ROS2' | 'General' — The name of the robot software suite (ROS distribution).
    - `version` 'Kinetic' | 'Melodic' | 'Dashing' | 'Foxy' — The version of the robot software suite (ROS distribution).
  - `renderingEngine` object — The rendering engine for the simulation application.
    - `name` 'OGRE' — The name of the rendering engine.
    - `version` string — The version of the rendering engine.
  - `lastUpdatedAt` string, date-time — The time, in milliseconds since the epoch, when the simulation application was last updated.
  - `revisionId` string — The revision ID of the simulation application.
  - `environment` object — The object that contains the Docker image URI used to create the simulation application.
    - `uri` string — The Docker image URI for either your robot or simulation applications.

## Other responses

- `480` — InvalidParameterException
- `481` — IdempotentParameterMismatchException
- `482` — LimitExceededException
- `483` — ThrottlingException
- `484` — InternalServerException

---

[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)