# Amazon Inspector API

> Amazon Inspector API on Apizie: 37 endpoints (Assigns attributes (key and value pairs) to the findings that are specified by the ARNs of the findings., Creates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup…, Creates an assessment template for the assessment target that is specified by the ARN of the assessment…, Starts the generation of an exclusions preview for the specified assessment template. The exclusions preview…, …) 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-inspector/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Amazon Inspector Amazon Inspector enables you to analyze the behavior of your AWS resources and to identify potential security issues. For more information, see Amazon Inspector User Guide .

## Endpoints

### Assigns attributes (key and value pairs) to the findings that are specified by the ARNs of the findings.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/add-attributes-to-findings` (byok)

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

### Creates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/create-assessment-target` (byok)

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

### Creates an assessment template for the assessment target that is specified by the ARN of the assessment…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/create-assessment-template` (byok)

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

### Starts the generation of an exclusions preview for the specified assessment template. The exclusions preview…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/create-exclusions-preview` (byok)

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

### Creates a resource group using the specified set of tags (key and value pairs) that are used to select the…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/create-resource-group` (byok)

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

### Deletes the assessment run that is specified by the ARN of the assessment run.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/delete-assessment-run` (byok)

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

### Deletes the assessment target that is specified by the ARN of the assessment target.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/delete-assessment-target` (byok)

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

### Deletes the assessment template that is specified by the ARN of the assessment template.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/delete-assessment-template` (byok)

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

### Describes the assessment runs that are specified by the ARNs of the assessment runs.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/describe-assessment-runs` (byok)

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

### Describes the assessment targets that are specified by the ARNs of the assessment targets.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/describe-assessment-targets` (byok)

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

### Describes the assessment templates that are specified by the ARNs of the assessment templates.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/describe-assessment-templates` (byok)

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

### Describes the IAM role that enables Amazon Inspector to access your AWS account.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/describe-cross-account-access-role` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |

### Describes the exclusions that are specified by the exclusions' ARNs.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/describe-exclusions` (byok)

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

### Describes the findings that are specified by the ARNs of the findings.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/describe-findings` (byok)

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

### Describes the resource groups that are specified by the ARNs of the resource groups.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/describe-resource-groups` (byok)

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

### Describes the rules packages that are specified by the ARNs of the rules packages.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/describe-rules-packages` (byok)

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

### Produces an assessment report that includes detailed and comprehensive results of a specified assessment run.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/get-assessment-report` (byok)

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

### Retrieves the exclusions preview (a list of ExclusionPreview objects) specified by the preview token. You…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/get-exclusions-preview` (byok)

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

### Information about the data that is collected for the specified assessment run.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/get-telemetry-metadata` (byok)

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

### Lists the agents of the assessment runs that are specified by the ARNs of the assessment runs.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/list-assessment-run-agents` (byok)

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

### Lists the assessment runs that correspond to the assessment templates that are specified by the ARNs of the…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/list-assessment-runs` (byok)

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

### Lists the ARNs of the assessment targets within this AWS account. For more information about assessment…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/list-assessment-targets` (byok)

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

### Lists the assessment templates that correspond to the assessment targets that are specified by the ARNs of…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/list-assessment-templates` (byok)

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

### Lists all the event subscriptions for the assessment template that is specified by the ARN of the assessment…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/list-event-subscriptions` (byok)

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

### List exclusions that are generated by the assessment run.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/list-exclusions` (byok)

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

### Lists findings that are generated by the assessment runs that are specified by the ARNs of the assessment…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/list-findings` (byok)

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

### Lists all available Amazon Inspector rules packages.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/list-rules-packages` (byok)

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

### Lists all tags associated with an assessment template.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/list-tags-for-resource` (byok)

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

### Previews the agents installed on the EC2 instances that are part of the specified assessment target.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/preview-agents` (byok)

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

### Registers the IAM role that grants Amazon Inspector access to AWS Services needed to perform security…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/register-cross-account-access-role` (byok)

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

### Removes entire attributes (key and value pairs) from the findings that are specified by the ARNs of the…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/remove-attributes-from-findings` (byok)

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

### Sets tags (key and value pairs) to the assessment template that is specified by the ARN of the assessment…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/set-tags-for-resource` (byok)

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

### Starts the assessment run specified by the ARN of the assessment template. For this API to function…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/start-assessment-run` (byok)

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

### Stops the assessment run that is specified by the ARN of the assessment run.
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/stop-assessment-run` (byok)

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

### Enables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/subscribe-to-event` (byok)

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

### Disables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/unsubscribe-from-event` (byok)

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

### Updates the assessment target that is specified by the ARN of the assessment target. If resourceGroupArn is…
`POST https://apizie.tech/v1/cloud:amazonaws-inspector/update-assessment-target` (byok)

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

## Example
```
curl "https://apizie.tech/v1/cloud:amazonaws-inspector/add-attributes-to-findings" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon Inspector API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:amazonaws-inspector/add-attributes-to-findings with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Amazon Inspector 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-inspector.

### What is the status of the Amazon Inspector API?
Needs your own provider key (bring your own key)