> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quivr.thevibecompany.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Count accepted and refused pushes per source instance

> Per-instance attempts to declared source API routes, split into received (2xx, including cached answers and GET challenges) and refused (all other answers). Includes authentication, scope, body, rate and IP refusals for existing instances. No payload, credentials, client IP or raw idempotency key is stored. Audit events and counters commit together. Requires observability:read on all Corpora; returns only the key's Organization. Uses the Spec 16 rollup windows and retention. By default lists the largest 100 instance/outcome pairs, with a total across every pair. Use connector_id to read both outcomes of one instance; its total then covers that instance only.



## OpenAPI

````yaml /openapi.yaml get /v0/admin/stats/connector-pushes
openapi: 3.1.0
info:
  title: Quivr HTTP API
  version: 0.0.0-draft
  description: >-
    Every endpoint of the Quivr v0 HTTP API. Send an API key as a bearer token;
    the key decides the Organization, the actions and the Corpora a request may
    reach.
servers: []
security:
  - ApiKey: []
paths:
  /v0/admin/stats/connector-pushes:
    get:
      tags:
        - Admin
      summary: Count accepted and refused pushes per source instance
      description: >-
        Per-instance attempts to declared source API routes, split into received
        (2xx, including cached answers and GET challenges) and refused (all
        other answers). Includes authentication, scope, body, rate and IP
        refusals for existing instances. No payload, credentials, client IP or
        raw idempotency key is stored. Audit events and counters commit
        together. Requires observability:read on all Corpora; returns only the
        key's Organization. Uses the Spec 16 rollup windows and retention. By
        default lists the largest 100 instance/outcome pairs, with a total
        across every pair. Use connector_id to read both outcomes of one
        instance; its total then covers that instance only.
      operationId: listConnectorPushStats
      parameters:
        - name: window
          in: query
          schema:
            type: string
            enum:
              - 1h
              - 24h
              - 7d
            default: 1h
        - name: limit
          in: query
          description: >-
            Largest instance/outcome pairs to list; cannot be combined with
            connector_id.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 100
        - name: connector_id
          in: query
          description: Read both outcomes of this instance; cannot be combined with limit.
          schema:
            type: string
            minLength: 1
            maxLength: 256
      responses:
        '200':
          description: Per-instance counters and time buckets.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorPushStatsList'
        default:
          description: Structured error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ConnectorPushStatsList:
      type: object
      additionalProperties: false
      properties:
        window:
          $ref: '#/components/schemas/StatsWindowName'
        resolution_seconds:
          type: integer
          minimum: 1
        from:
          type: string
          format: date-time
        to:
          type: string
          format: date-time
        total:
          type: integer
          minimum: 0
        items:
          type: array
          items:
            $ref: '#/components/schemas/ConnectorPushStats'
      required:
        - window
        - resolution_seconds
        - from
        - to
        - total
        - items
    Error:
      type: object
      additionalProperties: false
      properties:
        code:
          type: string
          minLength: 1
        message:
          type: string
          minLength: 1
        retryable:
          type: boolean
        field:
          type: string
          minLength: 1
          description: >-
            JSON Pointer (RFC 6901) to the request member that caused a 422,
            when known (for example /config/url or /credential/secret/token on
            connector commands).
        resync_url:
          type: string
          format: uri-reference
      required:
        - code
        - message
        - retryable
    StatsWindowName:
      type: string
      enum:
        - 1h
        - 24h
        - 7d
    ConnectorPushStats:
      type: object
      additionalProperties: false
      properties:
        connector_id:
          type: string
        outcome:
          type: string
          enum:
            - received
            - refused
        count:
          type: integer
          minimum: 0
        points:
          type: array
          items:
            $ref: '#/components/schemas/CountPoint'
      required:
        - connector_id
        - outcome
        - count
        - points
    CountPoint:
      type: object
      additionalProperties: false
      description: >-
        One non-empty bucket, starting at start and lasting the list's
        resolution_seconds.
      properties:
        start:
          type: string
          format: date-time
        count:
          type: integer
          minimum: 1
      required:
        - start
        - count
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      description: >-
        API key, not necessarily a JWT. Server derives Organization, permitted
        actions and Corpus scope; every resource access is authorized.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.