Grepr Integration Exceptions API

The Integration Exceptions API from Grepr — 9 operation(s) for integration exceptions.

Operations 11

GET /v1/integrations/{integrationId}/exceptions/estimation-datasets List estimation-eligible datasets for an integration #
GET /v1/integrations/{integrationId}/exceptions/impacts Get parsed alert query impacts for an integration and dataset #
GET /v1/integrations/{integrationId}/exceptions/usage Get the usage of an integration's parsed queries #
GET /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs List vendor estimation runs for an integration #
POST /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs Start a vendor estimation run #
POST /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/preview Preview a vendor estimation run #
DELETE /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId} Delete a vendor estimation run #
GET /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId} Get a vendor estimation run #
GET /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/results Get vendor estimation results for a run #
POST /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/resume Resume a stopped vendor estimation run #
POST /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/stop Stop a vendor estimation run #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/grepr:grepr-integration-exceptions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

grepr-integration-exceptions-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Grepr Integration Exceptions API
  version: 1.0.0
  description: 'Operations tagged Integration Exceptions across 2 of this provider''s published API definitions: grepr-openapi.json, grepr.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Integration Exceptions
paths:
  /v1/integrations/{integrationId}/exceptions/estimation-datasets:
    get:
      description: Returns datasets that are sinks of the integration's non-deleted pipelines, each with the pipelines that wire the integration to that dataset and the dataset's current estimation configuration (or null when not opted in). The estimation configuration is per-dataset and shared across every integration whose pipelines target the same dataset.
      operationId: getEstimationDatasets
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/EstimationDatasetSummary'
                type: array
          description: Estimation dataset summaries retrieved
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration not found.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: List estimation-eligible datasets for an integration
      tags:
      - Integration Exceptions
  /v1/integrations/{integrationId}/exceptions/impacts:
    get:
      description: Returns the estimated percentage of the dataset's raw log volume each of the integration's parsed alert queries matches, with the time that estimate was measured. Queries that have not been estimated are absent from the response rather than reported as zero. The dataset must be one of those returned by the estimation-datasets endpoint for this integration.
      operationId: getIntegrationExceptionImpactsByDataset
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      - description: Dataset the estimates are scoped to
        example: ds-prod-1
        in: query
        name: datasetId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties:
                  $ref: '#/components/schemas/ExceptionImpact'
                type: object
          description: Impact estimates retrieved
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration not found, or the dataset is not reachable from it.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Get parsed alert query impacts for an integration and dataset
      tags:
      - Integration Exceptions
  /v1/integrations/{integrationId}/exceptions/usage:
    get:
      description: Returns the usage the observability vendor reports for the source of each parsed query, such as when a Datadog dashboard was last viewed and its total views, with whether the last attempt to read it worked. Queries the vendor reported nothing for are absent rather than reported as never viewed.
      operationId: getIntegrationExceptionUsage
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionUsageResponse'
          description: Usage retrieved
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration not found.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Get the usage of an integration's parsed queries
      tags:
      - Integration Exceptions
  /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs:
    get:
      description: Returns the integration's estimation runs newest first, in every state.
      operationId: listVendorEstimationRuns
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      - description: Maximum runs to return, 1 to 100
        example: 20
        in: query
        name: limit
        schema:
          default: 20
          format: int32
          maximum: 100
          minimum: 1
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/VendorEstimationRun'
                type: array
          description: Runs retrieved
        '400':
          description: Bad Request - Limit is outside 1 to 100.
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration not found.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: List vendor estimation runs for an integration
      tags:
      - Integration Exceptions
    post:
      description: Creates a run over the given scope and window covering every exception the integration has imported. Runs are counted in the background, in short slices shared fairly between organizations.
      operationId: createVendorEstimationRun
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateVendorEstimationRunRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VendorEstimationRun'
          description: Run created
        '400':
          description: Bad Request - The window is inverted, starts or ends in the future, or is too long.
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration not found.
        '409':
          description: Conflict - The organization already has the most runs allowed in progress.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Start a vendor estimation run
      tags:
      - Integration Exceptions
  /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/preview:
    post:
      description: Returns how many exceptions and distinct queries a run would cover, and which exceptions cannot be counted because their query never parsed. Writes nothing.
      operationId: previewVendorEstimationRun
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateVendorEstimationRunRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VendorEstimationRunPreview'
          description: Preview computed
        '400':
          description: Bad Request - The window is inverted, starts or ends in the future, or is too long.
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration not found.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Preview a vendor estimation run
      tags:
      - Integration Exceptions
  /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}:
    delete:
      description: Deletes a stopped, complete or failed run and its results. A run in progress returns 409 and has to be stopped first.
      operationId: deleteVendorEstimationRun
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      - description: Run id
        example: 0q841q0j81m2q
        in: path
        name: runId
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Run deleted
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration or run not found.
        '409':
          description: Conflict - The run is in progress; stop it first.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Delete a vendor estimation run
      tags:
      - Integration Exceptions
    get:
      description: Returns the run's state and progress. Results are readable while it runs.
      operationId: getVendorEstimationRun
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      - description: Run id
        example: 0q841q0j81m2q
        in: path
        name: runId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VendorEstimationRun'
          description: Run retrieved
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration or run not found.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Get a vendor estimation run
      tags:
      - Integration Exceptions
  /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/results:
    get:
      description: Returns the run's per-exception estimates keyed by composite exception id. Each is counted, pending, unparseable or an error, selected by its type field. An exception missing from the response was not in this run.
      operationId: getVendorEstimationRunResults
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      - description: Run id
        example: 0q841q0j81m2q
        in: path
        name: runId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties:
                  $ref: '#/components/schemas/VendorEstimate'
                type: object
          description: Results retrieved
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration or run not found.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Get vendor estimation results for a run
      tags:
      - Integration Exceptions
  /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/resume:
    post:
      description: Makes a stopped run active again; counting continues where it stopped. Returns 409 for a run that is not stopped, or when the organization has the most runs allowed in progress.
      operationId: resumeVendorEstimationRun
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      - description: Run id
        example: 0q841q0j81m2q
        in: path
        name: runId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VendorEstimationRun'
          description: Run resumed
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration or run not found.
        '409':
          description: Conflict - The run cannot be resumed now.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Resume a stopped vendor estimation run
      tags:
      - Integration Exceptions
  /v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/stop:
    post:
      description: Stops the run and keeps every count it has made. A stopped run can be resumed or deleted. A no-op on a run that is not in progress.
      operationId: stopVendorEstimationRun
      parameters:
      - description: Integration id
        example: 0q841q0j81m2q
        in: path
        name: integrationId
        required: true
        schema:
          type: string
      - description: Run id
        example: 0q841q0j81m2q
        in: path
        name: runId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VendorEstimationRun'
          description: Run stopped
        '401':
          description: Unauthorized
        '404':
          description: Not Found - Integration or run not found.
      security:
      - grepr-api-key: []
      - grepr-oidc: []
      summary: Stop a vendor estimation run
      tags:
      - Integration Exceptions
components:
  schemas:
    DatadogQueryPredicate:
      properties:
        query:
          default: ''
          description: The datadog query used by the predicate. See https://docs.datadoghq.com/tracing/trace_explorer/query_syntax
          example: service:grepr-service-1
          type: string
        type:
          description: A predicate that checks if an event matches a datadog query.
          enum:
          - datadog-query
          type: string
      required:
      - query
      - type
      type: object
    VendorEstimatePending:
      description: This exception is in the run but has not been counted yet.
      properties:
        type:
          enum:
          - PENDING
          type: string
      required:
      - type
      type: object
    UsageStatus:
      description: The outcome of the last attempt to read the integration's usage
      properties:
        collectedAt:
          description: When usage was last read successfully. The usage returned is as of this time; absent when it was never read.
          example: '2026-09-27T18:45:03Z'
          format: date-time
          type: string
        detail:
          description: Why the last attempt failed, in words fit to show. Absent when it worked.
          example: the application key needs the dashboards_read permission
          type: string
        state:
          description: Whether the usage of the integration's parsed queries could be read
          enum:
          - OK
          - PENDING
          - PERMISSION_DENIED
          - NO_VIEWS
          - ERROR
          type: string
      required:
      - state
      type: object
    VendorEstimationRun:
      properties:
        createdAt:
          description: When the run was created
          format: date-time
          type: string
        failureReason:
          description: Why a FAILED run failed
          type: string
        id:
          description: Run id
          example: 0q841q0j81m2q
          type: string
        integrationId:
          description: Integration whose imported exceptions this run estimates
          example: 0q841q0j81m2q
          type: string
        predicatesDone:
          description: Predicates that have reached a non-pending status
          format: int32
          type: integer
        predicatesTotal:
          description: Distinct predicates in the run, fixed at creation
          format: int32
          type: integer
        requestedBy:
          description: Id of the user who started the run
          example: user-1
          type: string
        resumeAfter:
          description: When a THROTTLED run will be counted again
          format: date-time
          type: string
        scopeQuery:
          description: Vendor query limiting the estimate to part of the customer's traffic, applied to both the matched count and the total. Empty means all logs.
          example: service:broker-* AND env:prod
          type: string
        scopeTotalCount:
          description: Total events the scope matched over the window, the denominator
          format: int64
          type: integer
        state:
          description: Current run state
          enum:
          - QUEUED
          - RUNNING
          - THROTTLED
          - STOPPED
          - COMPLETE
          - FAILED
          type: string
        stopReason:
          description: 'Why a STOPPED run stopped: USER or TIMED_OUT'
          type: string
        updatedAt:
          description: When the run was last written to
          format: date-time
          type: string
        vendor:
          description: Vendor whose index the counts were made against
          enum:
          - DATADOG
          type: string
        windowEnd:
          description: Absolute end of the counted window, resolved at creation
          format: date-time
          type: string
        windowStart:
          description: Absolute start of the counted window, resolved at creation
          format: date-time
          type: string
      required:
      - createdAt
      - id
      - integrationId
      - predicatesDone
      - predicatesTotal
      - scopeQuery
      - state
      - updatedAt
      - vendor
      - windowEnd
      - windowStart
      type: object
    AndEventPredicate:
      properties:
        queries:
          default: []
          description: List of predicates that must all match for this predicate to match.
          items:
            $ref: '#/components/schemas/EventPredicate'
          maxItems: 2147483647
          minItems: 1
          title: Child predicates
          type: array
        type:
          description: A predicate that matches when every child predicate matches.
          enum:
          - and-predicate
          type: string
      required:
      - queries
      - type
      type: object
    NrqlQueryPredicate:
      properties:
        query:
          default: ''
          description: The Nrql query used by the predicate. See https://docs.newrelic.com/docs/nrql
          example: SELECT * FROM Log WHERE service = 'grepr-service-1'
          type: string
        strict:
          default: true
          description: Whether the query should be parsed in strict mode.
          type: boolean
        type:
          description: A predicate that checks if an event matches an NRQL query.
          enum:
          - nrql-query
          type: string
      required:
      - query
      - type
      type: object
    VendorEstimateUnparseable:
      description: The exception's query could not be parsed, so it was never counted.
      properties:
        message:
          description: The parse error recorded when the exception was imported
          example: unbalanced parenthesis at position 14
          type: string
        type:
          enum:
          - UNPARSEABLE
          type: string
      required:
      - message
      - type
      type: object
    ExceptionImpact:
      description: Estimated passthrough for one parsed alert query against one dataset
      properties:
        measuredAt:
          description: When the estimation run that produced this percentage completed. Absent when the age of the measurement is not known; that is not the same as freshly measured.
          example: '2026-09-09T04:15:00Z'
          format: date-time
          type: string
        percentage:
          description: Estimated percentage of the dataset's raw log volume this query matches. Honouring the query as a pipeline exception passes approximately this share of the data through without aggregation.
          example: 4.27
          format: double
          type: number
      required:
      - percentage
      type: object
    EstimationDatasetSummary:
      properties:
        config:
          $ref: '#/components/schemas/DatasetEstimationConfig'
        datasetId:
          description: Dataset this summary describes
          example: ds-prod-1
          type: string
        datasetName:
          description: Display name of the dataset
          example: logs-prod
          type: string
        pipelines:
          default: []
          items:
            $ref: '#/components/schemas/PipelineRef'
          type: array
      required:
      - datasetId
      - datasetName
      - pipelines
      type: object
    DatasetEstimationConfig:
      properties:
        createdAt:
          format: date-time
          readOnly: true
          type: string
        datasetId:
          readOnly: true
          type: string
        logLimit:
          default: 10000000
          description: Maximum number of log messages to scan per estimation run.
          example: 10000000
          format: int32
          maximum: 2147483647
          type: integer
        lookbackDuration:
          default: PT1H
          description: Time window of data to scan per estimation run. ISO-8601 duration format.
          example: PT20.345S
          format: ISO-8601
          type: string
        organizationId:
          readOnly: true
          type: string
        query:
          $ref: '#/components/schemas/EventPredicate'
        refreshPeriod:
          default: PT168H
          description: How often to recalculate impact percentages. ISO-8601 duration format.
          example: PT20.345S
          format: ISO-8601
          type: string
        updatedAt:
          format: date-time
          readOnly: true
          type: string
      required:
      - logLimit
      - lookbackDuration
      - refreshPeriod
      type: object
    ExceptionUsage:
      description: Usage the vendor reports for the source of one parsed query
      properties:
        lastViewedAt:
          description: When the source was last viewed. Null means the vendor reports it was never viewed.
          example: '2026-09-20T14:05:00Z'
          format: date-time
          type: string
        totalViews:
          description: How many times the source was viewed, as the vendor counts them. Datadog counts views since January 2025 and refreshes the count daily.
          example: 1204
          format: int64
          type: integer
      type: object
    VendorEstimate:
      description: What a run says about one exception. The type field selects the variant.
      discriminator:
        mapping:
          COUNTED: '#/components/schemas/VendorEstimateCounted'
          ERROR: '#/components/schemas/VendorEstimateError'
          PENDING: '#/components/schemas/VendorEstimatePending'
          UNPARSEABLE: '#/components/schemas/VendorEstimateUnparseable'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/VendorEstimateCounted'
      - $ref: '#/components/schemas/VendorEstimatePending'
      - $ref: '#/components/schemas/VendorEstimateUnparseable'
      - $ref: '#/components/schemas/VendorEstimateError'
      properties:
        type:
          type: string
      required:
      - type
      type: object
    PipelineRef:
      properties:
        id:
          description: Pipeline id
          example: pipe-prod-1
          type: string
        name:
          description: Pipeline display name
          example: prod
          type: string
      required:
      - id
      - name
      type: object
    NewRelicQueryPredicate:
      properties:
        query:
          default: ''
          description: 'The New Relic query used by the predicate. See https://docs.newrelic.com/docs/logs/ui-data/query-syntax-logs/ '
          example: service:grepr-service-1
          type: string
        type:
          description: A predicate that checks if an event matches a New Relic query.
          enum:
          - newrelic-query
          type: string
      required:
      - query
      - type
      type: object
    MetricEventPredicate:
      properties:
        filterTags:
          additionalProperties:
            default: {}
            description: The set of tags to query for. If unspecified, all tags are queried.
            example:
              env:
              - prod
              service:
              - my-app
            items:
              default: '{}'
              description: The set of tags to query for. If unspecified, all tags are queried.
              example: '{"service":["my-app"],"env":["prod"]}'
              type: string
            type: array
            uniqueItems: true
          default: {}
          description: The set of tags to query for. If unspecified, all tags are queried.
          example:
            env:
            - prod
            service:
            - my-app
          type: object
        metricNames:
          default: []
          description: The names of the metrics to query. Must not be empty.
          example:
          - cpu.load
          - cpu.utilization
          items:
            description: The names of the metrics to query. Must not be empty.
            example: '["cpu.load","cpu.utilization"]'
            type: string
          maxItems: 2147483647
          minItems: 1
          type: array
        query:
          type: string
        type:
          description: A predicate that checks if an event matches a metrics query.
          enum:
          - metric-predicate
          type: string
      required:
      - metricNames
      - query
      - type
      type: object
    ExceptionUsageResponse:
      description: Usage the vendor reports for an integration's parsed queries
      properties:
        reportedTypes:
          description: The parsed query exception types (values of a parsed query's exceptionType) the vendor reports usage for. Empty when the vendor reports none; a query of any other type has no usage to show.
          example:
          - DATADOG_DASHBOARD
          items:
            description: The parsed query exception types (values of a parsed query's exceptionType) the vendor reports usage for. Empty when the vendor reports none; a query of any other type has no usage to show.
            example: '["DATADOG_DASHBOARD"]'
            type: string
          type: array
        status:
          $ref: '#/components/schemas/UsageStatus'
        usage:
          additionalProperties:
            $ref: '#/components/schemas/ExceptionUsage'
          description: Usage keyed by composite exception id (integrationId:vendorResourceId:exceptionType), the key the impacts endpoint uses. A query the vendor reported nothing for is absent, which is not the same as never viewed.
          type: object
      required:
      - reportedTypes
      - status
      - usage
      type: object
    CreateVendorEstimationRunRequest:
      properties:
        scopeQuery:
          description: Vendor query limiting the estimate to part of the customer's traffic. Applied to both the matched count and the total. Leave empty for all logs.
          example: service:broker-* AND env:prod
          type: string
        windowEnd:
          description: Absolute end of the window to count over; must be after the start and not in the future
          format: date-time
          type: string
        windowStart:
          description: Absolute start of the window to count over
          format: date-time
          type: string
      required:
      - windowEnd
      - windowStart
      type: object
    EventPredicate:
      description: Predicate applied to rows before analytical aggregation.
      discriminator:
        mapping:
          and-predicate: '#/components/schemas/AndEventPredicate'
          datadog-query: '#/components/schemas/DatadogQueryPredicate'
          metric-predicate: '#/components/schemas/MetricEventPredicate'
          newrelic-query: '#/components/schemas/NewRelicQueryPredicate'
          nrql-query: '#/components/schemas/NrqlQueryPredicate'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/AndEventPredicate'
      - $ref: '#/components/schemas/DatadogQueryPredicate'
      - $ref: '#/components/schemas/MetricEventPredicate'
      - $ref: '#/components/schemas/NewRelicQueryPredicate'
      - $ref: '#/components/schemas/NrqlQueryPredicate'
      properties:
        query:
          type: string
        type:
          type: string
      required:
      - type
      type: object
    VendorEstimationRunPreview:
      properties:
        distinctQueries:
          description: Distinct countable predicates among those exceptions, and so the number of vendor calls the run would make. Smaller than the exception count wherever several exceptions carry the same query.
          format: int32
          type: integer
        exceptions:
          description: 'Exceptions the run would cover: every one the integration has imported'
          format: int32
          type: integer
        unparseable:
          description: Exceptions whose query could not be parsed at import and so cannot be counted, each with the parse error
          items:
            $ref: '#/components/schemas/UnparseableException'
          type: array
      required:
      - distinctQueries
      - exceptions
      - unparseable
      type: object
    UnparseableException:
      description: Exceptions whose query could not be parsed at import and so cannot be counted, each with the parse error
      properties:
        exceptionId:
          description: Composite exception id
          example: 0q841q0j81m2q:mon-123:DATADOG_MONITOR
          type: string
        message:
          description: The parse error recorded when the exception was imported
          example: unbalanced parenthesis at position 14
          type: string
      required:
      - exceptionId
      - message
      type: object
    VendorEstimateError:
      description: The count was attempted for this exception and failed.
      properties:
        message:
          description: The vendor's rejection, or the failure the call ended on
          example: query is too complex
          type: string
        type:
          enum:
          - ERROR
          type: string
      required:
      - message
      - type
      type: object
    VendorEstimateCounted:
      description: The vendor counted this query over the run's scope and window.
      properties:
        impactPercentage:
          description: Share of the scope's indexed logs this query matched, as a percentage of the run's scope total
          example: 6.2
          format: double
          type: number
        matchedCount:
          description: Events the query matched over the run's window
          example: 12874
          format: int64
          type: integer
        type:
          enum:
          - COUNTED
          type: string
      required:
      - impactPercentage
      - matchedCount
      - type
      type: object
  securitySchemes:
    grepr-api-key:
      in: header
      name: GREPR-API-KEY
      type: apiKey
    grepr-oidc:
      bearerFormat: JWT
      openIdConnectUrl: https://grepr-prod.us.auth0.com/.well-known/openid-configuration
      type: openIdConnect
x-refined-from:
- grepr-openapi.json
- grepr.json
x-tagGroups:
- name: Integrations
  tags:
  - Grepr-hosted Data Warehouse Integration
  - External S3 Data Warehouse Integration
  - Datadog Integration
  - New Relic Integration
  - Splunk Integration
  - Sumo Logic Integration
  - OpenTelemetry Integration
- name: Pipelines
  tags:
  - Jobs
  - Templates
  - Datasets
  - Status Metrics
  - External Triggers
  - Job Actions
  - Triggers
- name: Pipeline Components
  tags:
  - Operations
  - Transforms
  - Sources
  - Sinks
- name: Administration
  tags:
  - Users
  - Teams
  - Roles
  - Permission
  - Invitations
  - Activity Logs
- name: Organization
  tags:
  - Organizations
  - Access Configuration
  - Grepr API Key
  - Service Accounts
  - Signup
- name: Query & Analysis
  tags:
  - Job Anomalies
  - Grok Parsing
  - Query Parsing
  - Validation
- name: System
  tags:


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://artifacts.apis.io/grepr/openapi/grepr-integration-exceptions-api-openapi.yml