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

# Listar versões de especificação OpenAPI

> Utilize este endpoint para listar as versões publicadas de especificação OpenAPI disponíveis para um serviço nativo. A resposta marca a versão que o tenant atual fixou.



## OpenAPI

````yaml pt/openapi/v3-current/flowker.yaml get /v1/catalog/openapi-versions/{service}
openapi: 3.1.0
info:
  description: >-
    Referência completa da API para os serviços de orquestração de workflows do
    Flowker, incluindo gerenciamento de catálogo, definições de workflows,
    configurações de executor, configurações de provider e execuções de
    workflows.
  title: API do Flowker
  version: 1.2.0
servers:
  - url: https://flowker.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - name: Catalog API
    description: >-
      Explore providers, executors e triggers integrados disponíveis no catálogo
      do Flowker.
  - name: Workflows API
    description: Crie, atualize, ative, desative, clone e exclua definições de workflows.
  - name: Executions API
    description: Inicie execuções de workflows e acompanhe seu status e resultados.
  - name: Executor Configurations API
    description: >-
      Liste, consulte, atualize e exclua os registros de configuração de
      executor que uma implantação mantém.
  - name: Provider Configurations API
    description: >-
      Crie, atualize, habilite e desabilite as configurações de provider pelas
      quais os nodes de workflow chamam.
  - name: Dashboard API
    description: >-
      Recupere resumos agregados de workflows e execuções para dashboards
      operacionais.
  - name: Webhooks API
    description: >-
      Receba callbacks de webhooks de sistemas externos para disparar execuções
      de workflows.
  - name: Schedule API
    description: >-
      Inspecione as ocorrências agendadas futuras, ignoradas e retidas de um
      workflow, e execute ou descarte as retidas.
  - name: Schema Registry API
    description: >-
      Publique versões globais de especificação OpenAPI para serviços nativos e
      fixe a versão que cada tenant resolve.
  - name: OpenAPI Schemas API
    description: >-
      Envie, consulte e exclua os esquemas OpenAPI externos do tenant, e derive
      o contrato de uma operação específica.
  - name: XSD Schemas API
    description: >-
      Envie, consulte e exclua os esquemas XSD do tenant que validam as cargas
      XML dos webhooks.
paths:
  /v1/catalog/openapi-versions/{service}:
    get:
      tags:
        - Schema Registry API
      summary: Listar versões de especificação OpenAPI
      description: >-
        Utilize este endpoint para listar as versões publicadas de especificação
        OpenAPI disponíveis para um serviço nativo. A resposta marca a versão
        que o tenant atual fixou.
      operationId: listOpenAPIVersions
      parameters:
        - description: >-
            Identificador do serviço (o id do provider / segmento da chave
            global da spec, por exemplo ledger).
          in: path
          name: service
          required: true
          schema:
            description: >-
              Identificador do serviço (o id do provider / segmento da chave
              global da spec, por exemplo ledger).
            type: string
            example: ledger
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListVersionsResponse'
          description: >-
            Indica que a requisição foi bem-sucedida e a resposta contém os
            dados solicitados.
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            Indica que a requisição falhou. O corpo é um documento de problema
            RFC 9457.
components:
  schemas:
    ListVersionsResponse:
      additionalProperties: false
      properties:
        pinnedVersion:
          type: string
          example: '1'
        service:
          type: string
          example: ledger
        versions:
          items:
            type: string
          type:
            - array
            - 'null'
      required:
        - service
        - versions
        - pinnedVersion
      type: object
    ErrorResponse:
      properties:
        code:
          description: Código de erro do Flowker, estável e legível por máquina.
          example: FLK-0001
          type: string
        detail:
          description: >-
            Explicação legível desta ocorrência. Respostas com status 500 ou
            superior trazem uma mensagem genérica fixa.
          example: name is a required field
          type: string
        errors:
          description: Entradas por campo para uma requisição que não passou na validação.
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
        instance:
          description: Referência URI que identifica esta ocorrência específica.
          example: /v1/workflows
          format: uri
          type: string
        status:
          description: Código de status HTTP.
          example: 400
          type: integer
        title:
          description: Frase padrão do status HTTP. Ela não muda conforme o código de erro.
          example: Bad Request
          type: string
        type:
          description: >-
            Referência URI que identifica o erro. É sempre a base do catálogo de
            erros seguida do código.
          example: https://errors.lerian.studio/v1/FLK-0001
          format: uri
          type: string
      type: object
    ErrorDetail:
      properties:
        location:
          description: Onde está o problema, como body.nodes ou path.id.
          example: body.nodes
          type: string
        message:
          description: Descrição do problema no campo.
          example: expected array length >= 1
          type: string
        value:
          description: O valor que causou o erro, quando é seguro incluí-lo.
      type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Token bearer JWT emitido pelo provider de identidade. Envie-o no
        cabeçalho Authorization como `Bearer <token>`.

````