# Amazon Recycle Bin API

> Amazon Recycle Bin API on Apizie: 10 endpoints (Creates a Recycle Bin retention rule. For more information, see Create Recycle Bin retention rules in the…, Gets information about a Recycle Bin retention rule., Updates an existing Recycle Bin retention rule. You can update a retention rule's description, resource…, Deletes a Recycle Bin retention rule. For more information, see Delete Recycle Bin retention rules in the…, …) 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://zieapi.vercel.app/v1/cloud:amazonaws-rbin/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-rbin`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-rbin
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-rbin/openapi.json

This is the Recycle Bin API Reference . This documentation provides descriptions and syntax for each of the actions and data types in Recycle Bin. Recycle Bin is a resource recovery feature that enables you to restore…

## Endpoints

### Creates a Recycle Bin retention rule. For more information, see Create Recycle Bin retention rules in the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/create-rule` (byok)

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

### Gets information about a Recycle Bin retention rule.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/get-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| identifier | string | yes | The unique ID of the retention rule. |

### Updates an existing Recycle Bin retention rule. You can update a retention rule's description, resource…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/update-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| identifier | string | yes | The unique ID of the retention rule. |
| body | object | yes | JSON request body |

### Deletes a Recycle Bin retention rule. For more information, see Delete Recycle Bin retention rules in the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/delete-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| identifier | string | yes | The unique ID of the retention rule. |

### Lists the Recycle Bin retention rules in the Region.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/list-rules` (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 |

### Lists the tags assigned to a retention rule.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/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 retention rule. |

### Assigns tags to the specified retention rule.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The Amazon Resource Name (ARN) of the retention rule. |
| body | object | yes | JSON request body |

### Locks a retention rule. A locked retention rule can't be modified or deleted.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/lock-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| identifier | string | yes | The unique ID of the retention rule. |
| body | object | yes | JSON request body |

### Unlocks a retention rule. After a retention rule is unlocked, it can be modified or deleted only after the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/unlock-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| identifier | string | yes | The unique ID of the retention rule. |

### Unassigns a tag from a retention rule.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The Amazon Resource Name (ARN) of the retention rule. |
| tagKeys | array | yes | The tag keys of the tags to unassign. All tags that have the specified tag key are unassigned. |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/create-rule" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon Recycle Bin API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:amazonaws-rbin/create-rule with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Amazon Recycle Bin API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-rbin.

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