# EC2 Image Builder API

> EC2 Image Builder API on Apizie: 56 endpoints (CancelImageCreation cancels the creation of Image. This operation can only be used on images in a…, Creates a new component that can be used to build, validate, test, and assess your image. The component is…, Creates a new container recipe. Container recipes define how images are configured, tested, and assessed., Creates a new distribution configuration. Distribution configurations define and configure the outputs of…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:amazonaws-imagebuilder/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-imagebuilder`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://apizie.tech/api/cloud/amazonaws-imagebuilder
- OpenAPI: https://apizie.tech/api/cloud/amazonaws-imagebuilder/openapi.json

EC2 Image Builder is a fully managed Amazon Web Services service that makes it easier to automate the creation, management, and deployment of customized, secure, and up-to-date "golden" server images that are…

## Endpoints

### CancelImageCreation cancels the creation of Image. This operation can only be used on images in a…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/cancel-image-creation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Creates a new component that can be used to build, validate, test, and assess your image. The component is…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/create-component` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Creates a new container recipe. Container recipes define how images are configured, tested, and assessed.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/create-container-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Creates a new distribution configuration. Distribution configurations define and configure the outputs of…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/create-distribution-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Creates a new image. This request will create a new image along with all of the configured output resources…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/create-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Creates a new image pipeline. Image pipelines enable you to automate the creation and distribution of images.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/create-image-pipeline` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Creates a new image recipe. Image recipes define how images are configured, tested, and assessed.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/create-image-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Creates a new infrastructure configuration. An infrastructure configuration defines the environment in which…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/create-infrastructure-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Deletes a component build version.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/delete-component` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| componentBuildVersionArn | string | yes | The Amazon Resource Name (ARN) of the component build version to delete. |

### Deletes a container recipe.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/delete-container-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| containerRecipeArn | string | yes | The Amazon Resource Name (ARN) of the container recipe to delete. |

### Deletes a distribution configuration.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/delete-distribution-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| distributionConfigurationArn | string | yes | The Amazon Resource Name (ARN) of the distribution configuration to delete. |

### Deletes an Image Builder image resource. This does not delete any EC2 AMIs or ECR container images that are…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/delete-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| imageBuildVersionArn | string | yes | The Amazon Resource Name (ARN) of the Image Builder image resource to delete. |

### Deletes an image pipeline.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/delete-image-pipeline` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| imagePipelineArn | string | yes | The Amazon Resource Name (ARN) of the image pipeline to delete. |

### Deletes an image recipe.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/delete-image-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| imageRecipeArn | string | yes | The Amazon Resource Name (ARN) of the image recipe to delete. |

### Deletes an infrastructure configuration.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/delete-infrastructure-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| infrastructureConfigurationArn | string | yes | The Amazon Resource Name (ARN) of the infrastructure configuration to delete. |

### Gets a component object.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-component` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| componentBuildVersionArn | string | yes | The Amazon Resource Name (ARN) of the component that you want to get. Regex requires the suffix /\d+$ . |

### Gets a component policy.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-component-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| componentArn | string | yes | The Amazon Resource Name (ARN) of the component whose policy you want to retrieve. |

### Retrieves a container recipe.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-container-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| containerRecipeArn | string | yes | The Amazon Resource Name (ARN) of the container recipe to retrieve. |

### Retrieves the policy for a container recipe.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-container-recipe-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| containerRecipeArn | string | yes | The Amazon Resource Name (ARN) of the container recipe for the policy being requested. |

### Gets a distribution configuration.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-distribution-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| distributionConfigurationArn | string | yes | The Amazon Resource Name (ARN) of the distribution configuration that you want to retrieve. |

### Gets an image.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| imageBuildVersionArn | string | yes | The Amazon Resource Name (ARN) of the image that you want to get. |

### Gets an image pipeline.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-image-pipeline` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| imagePipelineArn | string | yes | The Amazon Resource Name (ARN) of the image pipeline that you want to retrieve. |

### Gets an image policy.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-image-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| imageArn | string | yes | The Amazon Resource Name (ARN) of the image whose policy you want to retrieve. |

### Gets an image recipe.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-image-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| imageRecipeArn | string | yes | The Amazon Resource Name (ARN) of the image recipe that you want to retrieve. |

### Gets an image recipe policy.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-image-recipe-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| imageRecipeArn | string | yes | The Amazon Resource Name (ARN) of the image recipe whose policy you want to retrieve. |

### Gets an infrastructure configuration.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-infrastructure-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| infrastructureConfigurationArn | string | yes | The Amazon Resource Name (ARN) of the infrastructure configuration that you want to retrieve. |

### Get the runtime information that was logged for a specific runtime instance of the workflow.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-workflow-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| workflowExecutionId | string | yes | Use the unique identifier for a runtime instance of the workflow to get runtime details. |

### Get the runtime information that was logged for a specific runtime instance of the workflow step.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/get-workflow-step-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| stepExecutionId | string | yes | Use the unique identifier for a specific runtime instance of the workflow step to get runtime details for that step. |

### Imports a component and transforms its data into a component document.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/import-component` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### When you export your virtual machine (VM) from its virtualization environment, that process creates a set of…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/import-vm-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Returns the list of component build versions for the specified semantic version. The semantic version has…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-component-build-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns the list of components that can be filtered by name, or by using the listed filters to streamline…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-components` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of container recipes.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-container-recipes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of distribution configurations.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-distribution-configurations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of image build versions.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-image-build-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### List the Packages that are associated with an Image Build Version, as determined by Amazon Web Services…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-image-packages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of images created by the specified pipeline.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-image-pipeline-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of image pipelines.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-image-pipelines` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of image recipes.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-image-recipes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of image scan aggregations for your account. You can filter by the type of key that Image…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-image-scan-finding-aggregations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of image scan findings for your account.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-image-scan-findings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns the list of images that you have access to. Newly created images can take up to two minutes to…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of infrastructure configurations.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-infrastructure-configurations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns the list of tags for the specified resource.
`GET https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The Amazon Resource Name (ARN) of the resource whose tags you want to retrieve. |

### Adds a tag to a resource.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The Amazon Resource Name (ARN) of the resource that you want to tag. |
| body | object | yes | JSON request body |

### Returns a list of workflow runtime instance metadata objects for a specific image build version.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-workflow-executions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Shows runtime data for each step in a runtime instance of the workflow that you specify in the request.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/list-workflow-step-executions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Applies a policy to a component. We recommend that you call the RAM API CreateResourceShare to share…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/put-component-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Applies a policy to a container image. We recommend that you call the RAM API CreateResourceShare…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/put-container-recipe-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Applies a policy to an image. We recommend that you call the RAM API CreateResourceShare to share resources.…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/put-image-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Applies a policy to an image recipe. We recommend that you call the RAM API CreateResourceShare to share…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/put-image-recipe-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Manually triggers a pipeline to create an image.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/start-image-pipeline-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Removes a tag from a resource.
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The Amazon Resource Name (ARN) of the resource that you want to untag. |
| tagKeys | array | yes | The tag keys to remove from the resource. |

### Updates a new distribution configuration. Distribution configurations define and configure the outputs of…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/update-distribution-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Updates an image pipeline. Image pipelines enable you to automate the creation and distribution of images.…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/update-image-pipeline` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Updates a new infrastructure configuration. An infrastructure configuration defines the environment in which…
`POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/update-infrastructure-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

## Example
```
curl "https://apizie.tech/v1/cloud:amazonaws-imagebuilder/cancel-image-creation" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the EC2 Image Builder API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:amazonaws-imagebuilder/cancel-image-creation with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the EC2 Image Builder API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. EC2 Image Builder itself also needs your own key from amazonaws.com.

### Can AI agents use the EC2 Image Builder API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-imagebuilder.

### What is the status of the EC2 Image Builder API?
Needs your own provider key (bring your own key)