ListInvitations - Amazon Detective


Retrieves the list of open and accepted behavior graph invitations for the member account. This operation can only be called by a member account.

Open invitations are invitations that the member account has not responded to.

The results do not include behavior graphs for which the member account declined the invitation. The results also do not include behavior graphs that the member account resigned from or was removed from.

Request Syntax

POST /invitations/list HTTP/1.1 Content-type: application/json { "MaxResults": number, "NextToken": "string" }

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.


The maximum number of behavior graph invitations to return in the response. The total must be less than the overall limit on the number of results to return, which is currently 200.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 200.

Required: No


For requests to retrieve the next page of results, the pagination token that was returned with the previous page of results. The initial request does not include a pagination token.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

Response Syntax

HTTP/1.1 200 Content-type: application/json { "Invitations": [ { "AccountId": "string", "DisabledReason": "string", "EmailAddress": "string", "GraphArn": "string", "InvitedTime": number, "MasterId": "string", "PercentOfGraphUtilization": number, "PercentOfGraphUtilizationUpdatedTime": number, "Status": "string", "UpdatedTime": number } ], "NextToken": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


The list of behavior graphs for which the member account has open or accepted invitations.

Type: Array of MemberDetail objects


If there are more behavior graphs remaining in the results, then this is the pagination token to use to request the next page of behavior graphs.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.


For information about the errors that are common to all actions, see Common Errors.


The request was valid but failed because of a problem with the service.

HTTP Status Code: 500


The request parameters are invalid.

HTTP Status Code: 400



Sample Request

POST /invitations/list HTTP/1.1 Host: Accept-Encoding: identity Content-Length: 0 Authorization: AUTHPARAMS X-Amz-Date: 20200124T193018Z User-Agent: aws-cli/1.14.29 Python/2.7.9 Windows/8 botocore/1.8.33


Sample Response

HTTP/1.1 200 OK Content-Type: application/json Content-Length: 302 Date: Fri, 24 Jan 2020 23:07:46 GMT x-amzn-RequestId: 397d0549-0092-11e8-a0ee-a7f9aa6e7572 Connection: Keep-alive { "Invitations": [ { "AccountId": "444455556666", "EmailAddress": "", "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899", "InvitedTime": 1579826107000, "MasterId": "111122223333", "Status": "INVITED", "UpdatedTime": 1579826107000 } ] }

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: