Help Center/ Resource Access Manager/ API Reference/ APIs/ Resource Sharing Invitations/ Rejecting a Resource Sharing Invitation
Updated on 2025-10-30 GMT+08:00
View PDF

Rejecting a Resource Sharing Invitation

Function

This API is used to reject a resource sharing invitation from other accounts.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    ram:resourceShareInvitations:reject

    Write

    resourceShareInvitation *

    -

    -

    -

    -

    ram:ShareOwnerAccountId

URI

POST /v1/resource-share-invitations/{resource_share_invitation_id}/reject

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

resource_share_invitation_id

Yes

String

ID of the resource sharing invitation.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Security-Token

No

String

Security token (session token) for temporary security credentials. This parameter is mandatory when you make an API call using temporary security credentials.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

resource_share_invitation

ResourceShareInvitation object

Details about the resource sharing invitation.
Table 4 ResourceShareInvitation

Parameter

Type

Description

receiver_account_id

String

ID of the account that receives the resource sharing invitation.

resource_share_id

String

ID of the resource share.

resource_share_name

String

Name of the resource share.

resource_share_invitation_id

String

ID of the resource sharing invitation.

sender_account_id

String

ID of the account that sends a resource sharing invitation.

status

String

Status of the resource sharing invitation.

created_at

String

Time when the invitation was created.

updated_at

String

Time when the invitation was last updated.

Example Requests

Rejecting resource sharing invitations from other accounts

POST /v1/resource-share-invitations/{resource_share_invitation_id}/reject

Example Responses

Status code: 200

Request succeeded.

{
  "resource_share_invitation" : {
    "receiver_account_id" : "string",
    "resource_share_id" : "string",
    "resource_share_name" : "string",
    "resource_share_invitation_id" : "string",
    "sender_account_id" : "string",
    "status" : "string",
    "created_at" : "2022-08-22T12:29:00.460Z",
    "updated_at" : "2022-08-22T12:29:00.460Z"
  }
}

Status Codes

Status Code

Description

200

Request succeeded.

Error Codes

See Error Codes.