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

# List organization inference-proxy request metadata

> Administrator-only retained request metadata. Bodies, query strings, credentials, and arbitrary headers are never returned or retained.



## OpenAPI

````yaml /openapi/next.yaml get /gateway/request-logs
openapi: 3.1.0
info:
  title: Blue — Service Contract
  version: 0.1.0
  description: >
    The client-side contract the `blue` CLI expects from the provisioned
    service. The reference `control-api` implements it; any BYO service that
    honors these shapes can be swapped in. Gateway-mode inference JWT issuance
    is OPTIONAL — governance-only deployments need only `GET
    /governance-config`. CLI callers use OAuth 2.0 access tokens issued through
    RFC 8628 device authorization; dashboard callers use an HTTP-only Better
    Auth session cookie.
servers:
  - url: https://harness.example.com
    description: Replace with the Control API URL for your deployment.
security:
  - oauthDevice: []
tags:
  - name: System
    description: Service health and authenticated identity.
  - name: Configuration
    description: Personalized governance policy and client reconciliation state.
  - name: Gateway
    description: Per-user managed inference-gateway credential lifecycle.
  - name: Sessions
    description: Raw-session upload, metadata, and download lifecycle.
  - name: Administration
    description: Organization-administrator policy and client operations.
  - name: User management
    description: >-
      Organization user lifecycle, session revocation, and invitation
      operations.
  - name: Identity provisioning
    description: SCIM 2.0 user and group provisioning for an external identity provider.
paths:
  /gateway/request-logs:
    get:
      tags:
        - Gateway
      summary: List organization inference-proxy request metadata
      description: >-
        Administrator-only retained request metadata. Bodies, query strings,
        credentials, and arbitrary headers are never returned or retained.
      operationId: listGatewayRequestLogs
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: per_page
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
        - name: q
          in: query
          description: >-
            Case-insensitive literal search across path, model, profile name,
            repository, branch, and run ID.
          schema:
            type: string
            maxLength: 200
        - name: user_id
          in: query
          schema:
            type: string
            format: uuid
        - name: profile_id
          in: query
          schema:
            type: string
        - name: model
          in: query
          schema:
            type: string
        - name: harness
          in: query
          schema:
            type: string
        - name: result
          in: query
          schema:
            $ref: '#/components/schemas/GatewayRequestResult'
        - name: occurred_from
          in: query
          description: Inclusive UTC calendar date.
          schema:
            type: string
            format: date
        - name: occurred_to
          in: query
          description: Inclusive UTC calendar date.
          schema:
            type: string
            format: date
        - name: sort
          in: query
          schema:
            type: string
            enum:
              - occurred_desc
              - occurred_asc
            default: occurred_desc
      responses:
        '200':
          description: A numbered page of retained request metadata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayRequestLogPage'
        '400':
          description: Invalid list parameters
        '403':
          description: Administrator access required
components:
  schemas:
    GatewayRequestResult:
      type: string
      enum:
        - success
        - redirect
        - client_error
        - server_error
        - transport_error
    GatewayRequestLogPage:
      type: object
      required:
        - items
        - page
        - per_page
        - total
        - total_pages
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/GatewayRequestLog'
        page:
          type: integer
          minimum: 1
        per_page:
          type: integer
          minimum: 1
          maximum: 100
        total:
          type: integer
          minimum: 0
        total_pages:
          type: integer
          minimum: 0
    GatewayRequestLog:
      type: object
      required:
        - id
        - user_id
        - user_email
        - occurred_at
        - method
        - path
        - result
        - upstream_latency_ms
      properties:
        id:
          type: string
          format: uuid
        user_id:
          type: string
          format: uuid
        user_email:
          type: string
          format: email
        profile_id:
          type:
            - string
            - 'null'
        profile_name:
          type:
            - string
            - 'null'
        occurred_at:
          type: string
          format: date-time
        method:
          type: string
        path:
          type: string
          description: Request path without query parameters.
        model:
          type:
            - string
            - 'null'
        http_status:
          type:
            - integer
            - 'null'
          minimum: 100
          maximum: 599
        result:
          $ref: '#/components/schemas/GatewayRequestResult'
        upstream_latency_ms:
          type: integer
          format: int64
          minimum: 0
          description: Time until upstream response headers or a transport failure.
        harness:
          type:
            - string
            - 'null'
        repository:
          type:
            - string
            - 'null'
        branch:
          type:
            - string
            - 'null'
        commit_sha:
          type:
            - string
            - 'null'
        dirty:
          type:
            - boolean
            - 'null'
        run_id:
          type:
            - string
            - 'null'
  securitySchemes:
    oauthDevice:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        OAuth 2.0 access token obtained through RFC 8628 at
        /api/auth/device/code and /api/auth/oauth2/token. The API enforces
        governance:read, session:write, and client-status:write as appropriate.

````