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

# List repo filter options

> List the distinct facet values (providers, VCS instances, and namespace
values) across the organization's repos, scoped by the given filters.

Used to populate the repos faceted filters. Each facet reflects every
filter except its own dimension, so alternative values stay visible (e.g.
the returned `providers` list isn't narrowed by the `provider` filter
itself). `namespace_values` cascades: it returns the values one level below
`namespace`, so drilling into a namespace reveals the next level.

Declared before the "/{org}/{repo_name}" route so the literal
"filter-options" segment is not captured as a repo name.



## OpenAPI

````yaml https://app.kosli.com/api/v2/openapi.json get /repos/{org}/filter-options
openapi: 3.1.0
info:
  title: Kosli API
  summary: The API for communicating with Kosli
  description: >

    # Authentication 


    When making requests against Kosli API, you can authenticate your requests
    using a bearer token. 

    Set the bearer token in the request Authorization header to a valid API
    key. 

    API Keys can be personal or for service accounts. Check the [service
    accounts
    documentation](https://docs.kosli.com/getting_started/service-accounts/) for
    details. 


    ## Curl example


    ```shell

    curl -H "Authorization: Bearer <<your-api-key>>"
    https://app.kosli.com/api/v2/environments/<<your-org-name>>

    ```
  version: '2.0'
servers:
  - url: https://app.kosli.com/api/v2
    description: EU
  - url: https://app.us.kosli.com/api/v2
    description: US
security:
  - HTTPBearer: []
paths:
  /repos/{org}/filter-options:
    get:
      tags:
        - Repos
      summary: List repo filter options
      description: >-
        List the distinct facet values (providers, VCS instances, and namespace

        values) across the organization's repos, scoped by the given filters.


        Used to populate the repos faceted filters. Each facet reflects every

        filter except its own dimension, so alternative values stay visible
        (e.g.

        the returned `providers` list isn't narrowed by the `provider` filter

        itself). `namespace_values` cascades: it returns the values one level
        below

        `namespace`, so drilling into a namespace reveals the next level.


        Declared before the "/{org}/{repo_name}" route so the literal

        "filter-options" segment is not captured as a repo name.
      operationId: list_repo_filter_options
      parameters:
        - name: org
          in: path
          required: true
          schema:
            type: string
            title: Org
        - name: provider
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                enum:
                  - github
                  - gitlab
                  - bitbucket
                  - bitbucket_cloud
                  - bitbucket_dc
                  - azure-devops
                  - azure_devops_services
                  - azure_devops_server
                  - circleci
                  - git
                  - subversion
              - type: 'null'
            description: Scope to repos with this VCS provider.
            title: Provider
          description: Scope to repos with this VCS provider.
        - name: vcs_instance
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Scope to repos with this VCS instance/host.
            title: Vcs Instance
          description: Scope to repos with this VCS instance/host.
        - name: namespace
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Scope to repos nested under this '/'-separated namespace prefix,
              e.g. platform/backend. The returned namespace_values are the
              distinct values one level below this prefix.
            title: Namespace
          description: >-
            Scope to repos nested under this '/'-separated namespace prefix,
            e.g. platform/backend. The returned namespace_values are the
            distinct values one level below this prefix.
        - name: tag
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            description: >-
              Scope to repos matching this tag key or key:value. Can be
              repeated.
            title: Tag
          description: Scope to repos matching this tag key or key:value. Can be repeated.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepoFilterOptionsResponse'
        '404':
          description: Resource Not Found
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/fastapi_app__errors__NotFoundResponse___locals___NotFoundResponseModel__40
      security:
        - HTTPBearer: []
        - HTTPBasic: []
components:
  schemas:
    RepoFilterOptionsResponse:
      properties:
        providers:
          items:
            type: string
            enum:
              - github
              - gitlab
              - bitbucket
              - bitbucket_cloud
              - bitbucket_dc
              - azure-devops
              - azure_devops_services
              - azure_devops_server
              - circleci
              - git
              - subversion
          type: array
          title: Providers
        vcs_instances:
          items:
            type: string
          type: array
          title: Vcs Instances
        namespace_values:
          items:
            type: string
          type: array
          title: Namespace Values
        _links:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Links
      type: object
      required:
        - providers
        - vcs_instances
        - namespace_values
      title: RepoFilterOptionsResponse
    fastapi_app__errors__NotFoundResponse___locals___NotFoundResponseModel__40:
      properties:
        message:
          type: string
          title: Message
          description: Error message
        errors:
          anyOf:
            - additionalProperties:
                type: string
              type: object
            - type: 'null'
          title: Errors
          description: Validation errors by field
      type: object
      required:
        - message
      title: NotFoundResponseModel
      description: Organization not found
      examples:
        - message: Organization not found
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````