> ## 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 esquemas XSD

> Utilize este endpoint para recuperar uma lista paginada dos esquemas XSD do tenant. A resposta traz apenas metadados, sem o conteúdo do esquema.



## OpenAPI

````yaml pt/openapi/v3-current/flowker.yaml get /v1/xsd-schemas
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/xsd-schemas:
    get:
      tags:
        - XSD Schemas API
      summary: Listar esquemas XSD
      description: >-
        Utilize este endpoint para recuperar uma lista paginada dos esquemas XSD
        do tenant. A resposta traz apenas metadados, sem o conteúdo do esquema.
      operationId: listXSDSchemas
      parameters:
        - description: Número de itens por página (1-100).
          explode: false
          in: query
          name: limit
          schema:
            default: 10
            description: Número de itens por página (1-100).
            format: int64
            type: integer
            example: 10
        - description: Cursor de paginação (opaco).
          explode: false
          in: query
          name: cursor
          schema:
            description: Cursor de paginação (opaco).
            type: string
        - description: Campo de ordenação.
          explode: false
          in: query
          name: sortBy
          schema:
            description: Campo de ordenação.
            type: string
            example: createdAt
        - description: Sentido da ordenação (ASC ou DESC).
          explode: false
          in: query
          name: sortOrder
          schema:
            description: Sentido da ordenação (ASC ou DESC).
            type: string
            example: DESC
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/XSDSchemaListOutput'
          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:
    XSDSchemaListOutput:
      additionalProperties: false
      properties:
        hasMore:
          type: boolean
          example: true
        items:
          items:
            $ref: '#/components/schemas/XSDSchemaOutput'
          type:
            - array
            - 'null'
        nextCursor:
          type: string
          example: eyJpZCI6IjAxOGYzZTJhIn0=
      required:
        - items
        - nextCursor
        - hasMore
      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
    XSDSchemaOutput:
      additionalProperties: false
      properties:
        byteSize:
          description: Tamanho do conteúdo do schema em bytes.
          format: int64
          type: integer
          example: 4096
        contentHash:
          description: Hash do conteúdo do schema para verificação de integridade.
          type: string
          example: >-
            sha256:9f2c8b1a4d7e0f3c6b5a8d2e1f4c7b0a3d6e9f2c5b8a1d4e7f0c3b6a9d2e5f8c
        createdAt:
          description: Data e hora de criação (RFC 3339).
          format: date-time
          type: string
          example: '2026-01-15T10:30:00Z'
        createdBy:
          description: Identidade que enviou o schema.
          type: string
          example: user@example.com
        id:
          description: Identificador do schema XSD.
          format: uuid
          type: string
          example: 018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8
        imports:
          description: Namespaces que este schema importa ou inclui.
          items:
            type: string
          type:
            - array
            - 'null'
          example:
            - urn:iso:std:iso:20022:tech:xsd:head.001.001.02
        name:
          description: Nome do schema.
          type: string
          example: pain.001
        targetNamespace:
          description: targetNamespace XSD declarado pelo schema.
          type: string
          example: urn:iso:std:iso:20022:tech:xsd:pain.001.001.09
        version:
          description: Versão do schema.
          type: string
          example: '1'
      required:
        - id
        - name
        - version
        - targetNamespace
        - contentHash
        - byteSize
        - imports
        - createdBy
        - createdAt
      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>`.

````