POST

/createWorldGenerationJob

http://robomaker.{region}.amazonaws.com/createWorldGenerationJob

Creates worlds using the specified template.

Access Token Required: API Key

Body Params

tagsobject

A map that contains tag keys and tag values that are attached to the world generator job.

templatestringrequired

The Amazon Resource Name (arn) of the world template describing the worlds you want to create.

worldTagsobject

A map that contains tag keys and tag values that are attached to the generated worlds.

worldCountobjectrequired

<p>The number of worlds that will be created. You can configure the number of unique floorplans and the number of unique interiors for each floor plan. For example, if you want 1 world with 20 unique interiors, you set <code>floorplanCount = 1</code> and <code>interiorCountPerFloorplan = 20</code>. This will result in 20 worlds (<code>floorplanCount</code> * <code>interiorCountPerFloorplan)</code>. </p> <p>If you set <code>floorplanCount = 4</code> and <code>interiorCountPerFloorplan = 5</code>, there will be 20 worlds with 5 unique floor plans. </p>

clientRequestTokenstring

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://robomaker.{region}.amazonaws.com/createWorldGenerationJob' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}