> ## 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.

# Enviar um esquema XSD

> Utilize este endpoint para enviar um arquivo de esquema XSD como multipart/form-data. O arquivo não deve exceder 1 MiB.



## OpenAPI

````yaml pt/openapi/v3-current/flowker.yaml post /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:
    post:
      tags:
        - XSD Schemas API
      summary: Enviar um esquema XSD
      description: >-
        Utilize este endpoint para enviar um arquivo de esquema XSD como
        multipart/form-data. O arquivo não deve exceder 1 MiB.
      operationId: createXSDSchema
      parameters:
        - description: >-
            Token bearer encaminhado ao sidecar validador de XSD para resolver
            os imports.
          in: header
          name: Authorization
          schema:
            description: >-
              Token bearer encaminhado ao sidecar validador de XSD para resolver
              os imports.
            type: string
      requestBody:
        content:
          multipart/form-data:
            encoding:
              file:
                contentType: application/octet-stream
              imports:
                contentType: text/plain
              name:
                contentType: text/plain
              version:
                contentType: text/plain
            schema:
              properties:
                file:
                  contentEncoding: binary
                  contentMediaType: application/octet-stream
                  description: XSD schema file.
                  format: binary
                  type: string
                imports:
                  description: Imported schema names (repeatable).
                  items:
                    type: string
                  type:
                    - array
                    - 'null'
                name:
                  description: Nome do schema.
                  type: string
                  example: pain-001
                version:
                  description: Versão do schema.
                  type: string
                  example: v1.0.0
              required:
                - file
                - name
                - version
              type: object
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/XSDSchemaOutput'
          description: >-
            Indica que o recurso foi criado com sucesso e a operação foi
            concluída conforme o esperado.
        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:
    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
    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>`.

````