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

# Obtener una plantilla del catálogo

> Utiliza este endpoint para recuperar los metadatos y el JSON Schema de parámetros de una plantilla específica del catálogo. Si la plantilla referencia configuraciones de provider, el schema se enriquece dinámicamente con las opciones de las configuraciones de provider activas.



## OpenAPI

````yaml es/openapi/v3-current/flowker.yaml get /v1/catalog/templates/{id}
openapi: 3.1.0
info:
  description: >-
    Referencia completa de la API para los servicios de orquestación de
    workflows de Flowker, incluyendo gestión de catálogo, definiciones de
    workflows, configuraciones de executor, configuraciones de provider y
    ejecuciones de workflows.
  title: API de Flowker
  version: 1.2.0
servers:
  - url: https://flowker.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - name: Catalog API
    description: >-
      Explora los providers, executors y triggers integrados disponibles en el
      catálogo de Flowker.
  - name: Workflows API
    description: >-
      Crea, actualiza, activa, desactiva, clona y elimina definiciones de
      workflows.
  - name: Executions API
    description: Inicia ejecuciones de workflows y rastrea su estado y sus resultados.
  - name: Executor Configurations API
    description: >-
      Lista, consulta, actualiza y elimina los registros de configuración de
      executor que mantiene un despliegue.
  - name: Provider Configurations API
    description: >-
      Crea, actualiza, habilita y deshabilita las configuraciones de provider
      por las que llaman los nodes de workflow.
  - name: Dashboard API
    description: >-
      Recupera resúmenes agregados de workflows y ejecuciones para dashboards
      operacionales.
  - name: Webhooks API
    description: >-
      Recibe callbacks de webhooks desde sistemas externos para disparar
      ejecuciones de workflows.
  - name: Schedule API
    description: >-
      Inspecciona las ocurrencias programadas próximas, omitidas y retenidas de
      un workflow, y ejecuta o descarta las retenidas.
  - name: Schema Registry API
    description: >-
      Publica versiones globales de especificación OpenAPI para servicios
      nativos y fija la versión que resuelve cada tenant.
  - name: OpenAPI Schemas API
    description: >-
      Sube, consulta y elimina los esquemas OpenAPI externos del tenant, y
      deriva el contrato de una operación concreta.
  - name: XSD Schemas API
    description: >-
      Sube, consulta y elimina los esquemas XSD del tenant que validan las
      cargas XML de los webhooks.
paths:
  /v1/catalog/templates/{id}:
    get:
      tags:
        - Catalog API
      summary: Obtener una plantilla del catálogo
      description: >-
        Utiliza este endpoint para recuperar los metadatos y el JSON Schema de
        parámetros de una plantilla específica del catálogo. Si la plantilla
        referencia configuraciones de provider, el schema se enriquece
        dinámicamente con las opciones de las configuraciones de provider
        activas.
      operationId: getCatalogTemplate
      parameters:
        - description: Identificador único de la plantilla del catálogo.
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogTemplateDetail'
          description: >-
            Indica que la solicitud fue exitosa y la respuesta contiene los
            datos solicitados.
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Indica que no se pudo encontrar el recurso solicitado.
components:
  schemas:
    CatalogTemplateDetail:
      properties:
        category:
          description: Categoría de la plantilla.
          example: payments
          type: string
        description:
          description: Descripción de la plantilla.
          example: >-
            Recibe una solicitud de webhook, valida la transacción con Tracer y
            crea una transacción en Midaz si se aprueba
          type: string
        id:
          description: Identificador único de la plantilla.
          example: tracer-midaz-validation
          type: string
        name:
          description: Nombre para mostrar de la plantilla.
          example: Tracer Validation + Midaz Transaction
          type: string
        paramSchema:
          description: >-
            JSON Schema que define los parámetros esperados para esta plantilla.
            Se enriquece dinámicamente con las opciones de las configuraciones
            de provider activas cuando es aplicable.
          example: '{"type":"object","properties":{"midaz_config_id":{"type":"string"}}}'
          type: string
        version:
          description: Versión de la plantilla.
          example: 1.0.0
          type: string
      type: object
    ErrorResponse:
      properties:
        code:
          description: Código de error de Flowker, estable y legible por máquina.
          example: FLK-0001
          type: string
        detail:
          description: >-
            Explicación legible de esta ocurrencia. Las respuestas con estado
            500 o superior llevan un mensaje genérico fijo.
          example: name is a required field
          type: string
        errors:
          description: Entradas por campo para una solicitud que no pasó la validación.
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
        instance:
          description: Referencia URI que identifica esta ocurrencia específica.
          example: /v1/workflows
          format: uri
          type: string
        status:
          description: Código de estado HTTP.
          example: 400
          type: integer
        title:
          description: >-
            Frase de estado HTTP estándar del status. No cambia según el código
            de error.
          example: Bad Request
          type: string
        type:
          description: >-
            Referencia URI que identifica el error. Siempre es la base del
            catálogo de errores seguida del código.
          example: https://errors.lerian.studio/v1/FLK-0001
          format: uri
          type: string
      type: object
    ErrorDetail:
      properties:
        location:
          description: Dónde está el problema, como body.nodes o path.id.
          example: body.nodes
          type: string
        message:
          description: Descripción del problema a nivel de campo.
          example: expected array length >= 1
          type: string
        value:
          description: El valor que causó el error, cuando es seguro incluirlo.
      type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Token bearer JWT emitido por el provider de identidad. Envíalo en la
        cabecera Authorization como `Bearer <token>`.

````