# AWS Resource Access Manager API

> AWS Resource Access Manager API on Apizie: 34 endpoints (Accepts an invitation to a resource share from another Amazon Web Services account. After you accept the…, Adds the specified list of principals and list of resources to a resource share. Principals that already…, Adds or replaces the RAM permission for a resource type included in a resource share. You can have exactly…, Creates a customer managed permission for a specified resource type that you can attach to resource shares.…, …) 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-ram/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

This is the Resource Access Manager API Reference . This documentation provides descriptions and syntax for each of the actions and data types in RAM. RAM is a service that helps you securely share your Amazon Web…

## Endpoints

### Accepts an invitation to a resource share from another Amazon Web Services account. After you accept the…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/accept-resource-share-invitation` (byok)

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

### Adds the specified list of principals and list of resources to a resource share. Principals that already…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/associate-resource-share` (byok)

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

### Adds or replaces the RAM permission for a resource type included in a resource share. You can have exactly…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/associate-resource-share-permission` (byok)

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

### Creates a customer managed permission for a specified resource type that you can attach to resource shares.…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/create-permission` (byok)

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

### Creates a new version of the specified customer managed permission. The new version is automatically set as…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/create-permission-version` (byok)

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

### Creates a resource share. You can provide a list of the Amazon Resource Names (ARNs) for the resources that…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/create-resource-share` (byok)

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

### Deletes the specified customer managed permission in the Amazon Web Services Region in which you call this…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/delete-permission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| permissionArn | string | yes | Specifies the Amazon Resource Name (ARN) of the customer managed permission that you want to delete. |
| clientToken | string | no | Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the… |

### Deletes one version of a customer managed permission. The version you specify must not be attached to any…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/delete-permission-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| permissionArn | string | yes | Specifies the Amazon Resource Name (ARN) of the permission with the version you want to delete. |
| permissionVersion | integer | yes | Specifies the version number to delete. You can't delete the default version for a customer managed permission. You can't delete a version… |
| clientToken | string | no | Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the… |

### Deletes the specified resource share. This doesn't delete any of the resources that were associated with the…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/delete-resource-share` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceShareArn | string | yes | Specifies the Amazon Resource Name (ARN) of the resource share to delete. |
| clientToken | string | no | Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the… |

### Removes the specified principals or resources from participating in the specified resource share.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/disassociate-resource-share` (byok)

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

### Removes a managed permission from a resource share. Permission changes take effect immediately. You can…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/disassociate-resource-share-permission` (byok)

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

### Enables resource sharing within your organization in Organizations. This operation creates a service-linked…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/enable-sharing-with-aws-organization` (byok)

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

### Retrieves the contents of a managed permission in JSON format.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/get-permission` (byok)

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

### Retrieves the resource policies for the specified resources that you own and have shared.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/get-resource-policies` (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 |

### Retrieves the lists of resources and principals that associated for resource shares that you own.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/get-resource-share-associations` (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 |

### Retrieves details about invitations that you have received for resource shares.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/get-resource-share-invitations` (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 |

### Retrieves details about the resource shares that you own or that are shared with you.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/get-resource-shares` (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 resources in a resource share that is shared with you but for which the invitation is still…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/list-pending-invitation-resources` (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 information about the managed permission and its associations to any resource shares that use this…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/list-permission-associations` (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 available versions of the specified RAM permission.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/list-permission-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 |

### Retrieves a list of available RAM permissions that you can use for the supported resource types.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/list-permissions` (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 principals that you are sharing resources with or that are sharing resources with you.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/list-principals` (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 |

### Retrieves the current status of the asynchronous tasks performed by RAM when you perform the…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/list-replace-permission-associations-work` (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 RAM permissions that are associated with a resource share.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/list-resource-share-permissions` (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 resource types that can be shared by RAM.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/list-resource-types` (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 resources that you added to a resource share or the resources that are shared with you.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/list-resources` (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 |

### When you attach a resource-based policy to a resource, RAM automatically creates a resource share of…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/promote-permission-created-from-policy` (byok)

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

### When you attach a resource-based policy to a resource, RAM automatically creates a resource share of…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/promote-resource-share-created-from-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceShareArn | string | yes | Specifies the Amazon Resource Name (ARN) of the resource share to promote. |

### Rejects an invitation to a resource share from another Amazon Web Services account.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/reject-resource-share-invitation` (byok)

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

### Updates all resource shares that use a managed permission to a different managed permission. This operation…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/replace-permission-associations` (byok)

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

### Designates the specified version number as the default version for the specified customer managed…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/set-default-permission-version` (byok)

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

### Adds the specified tag keys and values to a resource share or managed permission. If you choose a resource…
`POST https://apizie.tech/v1/cloud:amazonaws-ram/tag-resource` (byok)

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

### Removes the specified tag key and value pairs from the specified resource share or managed permission.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/untag-resource` (byok)

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

### Modifies some of the properties of the specified resource share.
`POST https://apizie.tech/v1/cloud:amazonaws-ram/update-resource-share` (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-ram/accept-resource-share-invitation" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS Resource Access Manager API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:amazonaws-ram/accept-resource-share-invitation with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the AWS Resource Access Manager 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-ram.

### What is the status of the AWS Resource Access Manager API?
Needs your own provider key (bring your own key)