Google Cloud Error Reporting V1beta1 API

openapi: 3.1.0
info:
  title: Google Cloud Error Reporting V1beta1 API
  description: The Error Reporting API enables listing error events, retrieving error group statistics, reporting new errors, and managing error groups. It groups and counts similar errors from cloud services and applications and provides programmatic access to error data and statistics.
  version: v1beta1
  contact:
    name: Google Cloud
    url: https://cloud.google.com/error-reporting
servers:
- url: https://clouderrorreporting.googleapis.com
tags:
- name: V1beta1
paths:
  /v1beta1/projects/{projectId}/events:
    get:
      operationId: listEvents
      summary: Google Cloud Error Reporting List Error Events
      description: Lists the specified events.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: groupId
        in: query
        required: true
        schema:
          type: string
        description: The group for which events are returned.
      - name: pageSize
        in: query
        schema:
          type: integer
      - name: pageToken
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListEventsResponse'
      tags:
      - V1beta1
  /v1beta1/projects/{projectId}/events:report:
    post:
      operationId: reportEvent
      summary: Google Cloud Error Reporting Report Error Event
      description: Reports an individual error event.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReportedErrorEvent'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportErrorEventResponse'
      tags:
      - V1beta1
  /v1beta1/projects/{projectId}/groupStats:
    get:
      operationId: listGroupStats
      summary: Google Cloud Error Reporting List Group Stats
      description: Lists the specified groups with error count statistics.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: timeRange.period
        in: query
        schema:
          type: string
          enum:
          - PERIOD_1_HOUR
          - PERIOD_6_HOURS
          - PERIOD_1_DAY
          - PERIOD_1_WEEK
          - PERIOD_30_DAYS
      - name: pageSize
        in: query
        schema:
          type: integer
      - name: pageToken
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListGroupStatsResponse'
      tags:
      - V1beta1
  /v1beta1/projects/{projectId}/groups/{groupId}:
    get:
      operationId: getGroup
      summary: Google Cloud Error Reporting Get Error Group
      description: Gets the specified error group.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: groupId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorGroup'
      tags:
      - V1beta1
    put:
      operationId: updateGroup
      summary: Google Cloud Error Reporting Update Error Group
      description: Replaces the data for the specified group.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      - name: groupId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ErrorGroup'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorGroup'
      tags:
      - V1beta1
  /v1beta1/projects/{projectId}/events:deleteAll:
    delete:
      operationId: deleteEvents
      summary: Google Cloud Error Reporting Delete All Events
      description: Deletes all error events for the specified project.
      parameters:
      - name: projectId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
      tags:
      - V1beta1
components:
  schemas:
    ReportErrorEventResponse:
      type: object
      description: Response for reporting an error event.
    ErrorGroup:
      type: object
      description: A group of related error events.
      properties:
        name:
          type: string
        groupId:
          type: string
        trackingIssues:
          type: array
          items:
            type: object
            properties:
              url:
                type: string
        resolutionStatus:
          type: string
          enum:
          - OPEN
          - ACKNOWLEDGED
          - RESOLVED
          - MUTED
    ListEventsResponse:
      type: object
      properties:
        errorEvents:
          type: array
          items:
            $ref: '#/components/schemas/ErrorEvent'
        nextPageToken:
          type: string
        timeRangeBegin:
          type: string
          format: date-time
    ListGroupStatsResponse:
      type: object
      properties:
        errorGroupStats:
          type: array
          items:
            $ref: '#/components/schemas/ErrorGroupStats'
        nextPageToken:
          type: string
        timeRangeBegin:
          type: string
          format: date-time
    ErrorContext:
      type: object
      description: Contextual information about the error.
      properties:
        httpRequest:
          type: object
          properties:
            method:
              type: string
            url:
              type: string
            userAgent:
              type: string
            referrer:
              type: string
            responseStatusCode:
              type: integer
            remoteIp:
              type: string
        user:
          type: string
          description: The user who caused the error.
        reportLocation:
          type: object
          properties:
            filePath:
              type: string
            lineNumber:
              type: integer
            functionName:
              type: string
    ServiceContext:
      type: object
      description: Describes a running service that sends error reports.
      properties:
        service:
          type: string
          description: The name of the service.
        version:
          type: string
          description: The version of the service.
        resourceType:
          type: string
          description: Type of the resource reporting the error.
    ErrorGroupStats:
      type: object
      description: Statistics for an error group.
      properties:
        group:
          $ref: '#/components/schemas/ErrorGroup'
        count:
          type: string
          description: Approximate total number of events in the group.
        affectedUsersCount:
          type: string
        firstSeenTime:
          type: string
          format: date-time
        lastSeenTime:
          type: string
          format: date-time
        affectedServices:
          type: array
          items:
            $ref: '#/components/schemas/ServiceContext'
        numAffectedServices:
          type: integer
        representative:
          $ref: '#/components/schemas/ErrorEvent'
    ErrorEvent:
      type: object
      description: An individual error event.
      properties:
        eventTime:
          type: string
          format: date-time
          description: The time the event was received.
        serviceContext:
          $ref: '#/components/schemas/ServiceContext'
        message:
          type: string
          description: The error message and stack trace.
        context:
          $ref: '#/components/schemas/ErrorContext'
    ReportedErrorEvent:
      type: object
      description: An error event reported by the application.
      properties:
        eventTime:
          type: string
          format: date-time
        serviceContext:
          $ref: '#/components/schemas/ServiceContext'
        message:
          type: string
          description: The error message including stack trace.
        context:
          $ref: '#/components/schemas/ErrorContext'
      required:
      - serviceContext
      - message
externalDocs:
  description: Google Cloud Error Reporting Documentation
  url: https://cloud.google.com/error-reporting/docs