openapi: 3.1.0
info:
  title: Google Looker Authentication Looks API
  description: A simplified OpenAPI representation for Google Looker covering core Looker API 4.0 endpoints used to authenticate, fetch users, and run looks. This spec is a curated index entry pointing to the upstream Looker OpenAPI for full coverage.
  version: 4.0.0
  contact:
    name: Google Looker
    url: https://cloud.google.com/looker/docs/api-overview
servers:
- url: https://your-instance.cloud.looker.com:19999/api/4.0
  description: Looker instance API endpoint (replace your-instance).
security:
- BearerAuth: []
tags:
- name: Looks
paths:
  /looks:
    get:
      operationId: getAllLooks
      summary: Get All Looks
      description: Return a list of saved Looker Looks (saved query visualizations) that the authenticated user has permission to view.
      tags:
      - Looks
      responses:
        '200':
          description: Successful response containing a list of saved Looks.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Look'
  /looks/{look_id}/run/{result_format}:
    get:
      operationId: runLook
      summary: Run Look
      description: Execute a saved Look and return its query results in the requested output format such as json, csv, or html.
      tags:
      - Looks
      parameters:
      - name: look_id
        in: path
        required: true
        description: Numeric identifier of the Look to execute.
        schema:
          type: string
      - name: result_format
        in: path
        required: true
        description: Output format for the executed Look results.
        schema:
          type: string
          enum:
          - json
          - json_detail
          - csv
          - html
          - md
          - xlsx
          - sql
          - png
          - jpg
      responses:
        '200':
          description: Successful response containing the rendered Look results.
          content:
            application/json:
              schema:
                type: object
components:
  schemas:
    Look:
      type: object
      description: A saved Looker Look (visualized query).
      properties:
        id:
          type: string
          description: Unique identifier for the Look.
        title:
          type: string
          description: Display title of the Look.
        description:
          type: string
          description: Author-provided description of the Look.
        public:
          type: boolean
          description: Indicates whether the Look is publicly accessible.
        query_id:
          type: string
          description: Identifier of the underlying query used to render the Look.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer