PutRumEvents - CloudWatch RUM


Sends telemetry events about your application performance and user behavior to CloudWatch RUM. The code snippet that RUM generates for you to add to your application includes PutRumEvents operations to send this data to RUM.

Each PutRumEvents operation can send a batch of events from one user session.

Request Syntax

POST /appmonitors/Id/ HTTP/1.1 Content-type: application/json { "AppMonitorDetails": { "id": "string", "name": "string", "version": "string" }, "BatchId": "string", "RumEvents": [ { "details": "string", "id": "string", "metadata": "string", "timestamp": number, "type": "string" } ], "UserDetails": { "sessionId": "string", "userId": "string" } }

URI Request Parameters

The request uses the following URI parameters.


The ID of the app monitor that is sending this data.

Length Constraints: Fixed length of 36.

Pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

Required: Yes

Request Body

The request accepts the following data in JSON format.


A structure that contains information about the app monitor that collected this telemetry information.

Type: AppMonitorDetails object

Required: Yes


A unique identifier for this batch of RUM event data.

Type: String

Length Constraints: Fixed length of 36.

Pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

Required: Yes


An array of structures that contain the telemetry event data.

Type: Array of RumEvent objects

Required: Yes


A structure that contains information about the user session that this batch of events was collected from.

Type: UserDetails object

Required: Yes

Response Syntax

HTTP/1.1 200

Response Elements

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


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


You don't have sufficient permissions to perform this action.

HTTP Status Code: 403


Internal service exception.

HTTP Status Code: 500


Resource not found.

HTTP Status Code: 404


The request was throttled because of quota limits.

HTTP Status Code: 429


One of the arguments for the request is not valid.

HTTP Status Code: 400

See Also

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