Report an individual error event and record the event to a log.
This endpoint accepts either an OAuth token, or an API key for authentication. To use an API key, append it to the URL as the value of a key parameter. For example:
POST
https://clouderrorreporting.googleapis.com/v1beta1/{projectName}/events:report?key=123ABC456
Note:Error Reporting is a service built on Cloud Logging and can analyze log entries when all of the following are true:
Customer-managed encryption keys (CMEK) are disabled on the log bucket.
The log bucket satisfies one of the following:
The log bucket is stored in the same project where the logs originated.
The logs were routed to a project, and then that project stored those logs in a log bucket that it owns.
HTTP request
POST https://clouderrorreporting.googleapis.com/v1beta1/{projectName=projects/*}/events:report
Required. The resource name of the Google Cloud Platform project. Written as projects/{projectId}, where {projectId} is the Google Cloud Platform project ID.
Optional. Time when the event occurred. If not provided, the time when the event was received by the Error Reporting system is used. If provided, the time must not exceed the logs retention period in the past, or be more than 24 hours in the future. If an invalid time is provided, then an error is returned.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Required. The service context in which this error has occurred.
message
string
Required. The error message. If no context.reportLocation is provided, the message must contain a header (typically consisting of the exception type name and an error message) and an exception stack trace in one of the supported programming languages and formats. Supported languages are Java, Python, JavaScript, Ruby, C#, PHP, and Go. Supported stack trace formats are:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-14 UTC."],[[["\u003cp\u003eThis endpoint allows you to report individual error events and log them to the Error Reporting service.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication can be achieved using either an OAuth token or an API key, which can be appended to the URL as a \u003ccode\u003ekey\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request to report an error is a \u003ccode\u003ePOST\u003c/code\u003e request to the URL: \u003ccode\u003ehttps://clouderrorreporting.googleapis.com/v1beta1/{projectName=projects/*}/events:report\u003c/code\u003e, with the \u003ccode\u003eprojectName\u003c/code\u003e being a required path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an instance of \u003ccode\u003eReportedErrorEvent\u003c/code\u003e, detailing the error, while a successful response will have an empty body.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eReportedErrorEvent\u003c/code\u003e includes fields like \u003ccode\u003eeventTime\u003c/code\u003e, \u003ccode\u003eserviceContext\u003c/code\u003e, \u003ccode\u003emessage\u003c/code\u003e, and \u003ccode\u003econtext\u003c/code\u003e, where the \u003ccode\u003emessage\u003c/code\u003e field must contain a formatted error, and service context is a required field.\u003c/p\u003e\n"]]],[],null,["# Method: projects.events.report\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [ReportedErrorEvent](#ReportedErrorEvent)\n - [JSON representation](#ReportedErrorEvent.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nReport an individual error event and record the event to a log.\n\nThis endpoint accepts **either** an OAuth token, **or** an [API key](https://support.google.com/cloud/answer/6158862) for authentication. To use an API key, append it to the URL as the value of a `key` parameter. For example:\n\n`POST\nhttps://clouderrorreporting.googleapis.com/v1beta1/{projectName}/events:report?key=123ABC456`\n\n**Note:** [Error Reporting](https://cloud.google.com/error-reporting) is a service built on Cloud Logging and can analyze log entries when all of the following are true:\n\n- Customer-managed encryption keys (CMEK) are disabled on the log bucket.\n- The log bucket satisfies one of the following:\n - The log bucket is stored in the same project where the logs originated.\n - The logs were routed to a project, and then that project stored those logs in a log bucket that it owns.\n\n### HTTP request\n\n`POST https://clouderrorreporting.googleapis.com/v1beta1/{projectName=projects/*}/events:report`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains an instance of [ReportedErrorEvent](/error-reporting/reference/rest/v1beta1/projects.events/report#ReportedErrorEvent).\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/stackdriver-integration`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\nReportedErrorEvent\n------------------\n\nAn error event which is reported to the Error Reporting system."]]
