> ## 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. # Actualizar una configuración de provider > Utiliza este endpoint para actualizar una configuración de provider existente. Si el payload de la configuración cambia, se revalida contra el JSON Schema del provider. ## OpenAPI ````yaml es/openapi/v3-current/flowker.yaml patch /v1/provider-configurations/{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/provider-configurations/{id}: patch: tags: - Provider Configurations API summary: Actualizar una configuración de provider description: >- Utiliza este endpoint para actualizar una configuración de provider existente. Si el payload de la configuración cambia, se revalida contra el JSON Schema del provider. operationId: updateProviderConfiguration parameters: - description: Identificador único de la configuración de provider. in: path name: id required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateProviderConfigurationInput' description: >- Cuerpo de la solicitud que contiene los detalles actualizados de la configuración de provider. required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/ProviderConfigurationOutput' description: >- Indica que la solicitud fue exitosa y la respuesta contiene los datos solicitados. '400': content: application/problem+json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que la solicitud estaba mal formada o contenía parámetros no válidos. '404': content: application/problem+json: schema: $ref: '#/components/schemas/ErrorResponse' description: Indica que no se pudo encontrar el recurso solicitado. '409': content: application/problem+json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que la solicitud no pudo completarse debido a un conflicto con el estado actual del recurso. '422': content: application/problem+json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que la solicitud estaba bien formada pero contiene errores semánticos que impiden el procesamiento. '500': content: application/problem+json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica un error interno inesperado. Si persiste, contacta al soporte. components: schemas: UpdateProviderConfigurationInput: properties: allowedHosts: description: >- Reemplaza la lista de hosts permitidos. Omite el campo para dejar la lista almacenada sin cambios. Envía una lista vacía para borrarla, y una lista no vacía para reemplazarla. La lista nueva debe cumplir las mismas reglas que en la creación, incluida la comprobación de cobertura de la URL base y la regla del provider HTTP genérico. items: maxLength: 253 type: string maxItems: 100 type: array example: - api.acme.com - .kyc-provider.io allowedPrivateHosts: description: >- Reemplaza el conjunto de hosts privados permitidos. Omite el campo para dejar el conjunto almacenado sin cambios. Envía una lista vacía para borrarlo, y una lista no vacía para reemplazarlo. Las entradas siguen el mismo formato que en la creación. items: maxLength: 253 type: string maxItems: 100 type: array example: - nginx.pix-inline.internal config: additionalProperties: type: object description: Configuración específica del provider actualizada. type: object description: description: Descripción actualizada. example: ClearSale anti-fraud — updated with new API version maxLength: 500 type: string metadata: additionalProperties: type: object description: Metadatos actualizados. type: object name: description: Nombre actualizado. example: ClearSale Production v2 maxLength: 100 minLength: 1 type: string schemaBindings: description: >- Reemplaza los vínculos con esquemas. Omite el campo para dejar los vínculos almacenados sin cambios. Envía una lista vacía para quitarlos todos, y una lista no vacía para reemplazar el conjunto. Flowker verifica cada entrada contra los esquemas almacenados antes de guardar nada. items: $ref: '#/components/schemas/SchemaBindingInput' maxItems: 100 type: array type: object ProviderConfigurationOutput: example: id: c3d4e5f6-a7b8-9012-cdef-345678901234 name: ClearSale Production description: ClearSale anti-fraud for Pix transactions providerId: clearsale kind: catalog config: baseUrl: https://api.clearsale.com.br environment: production allowedHosts: - api.clearsale.com.br schemaBindings: [] status: active metadata: team: risk createdAt: '2026-03-17T14:00:00Z' updatedAt: '2026-03-17T14:00:00Z' properties: allowedHosts: description: >- Lista de hosts de destino permitidos para las llamadas salientes. El campo no aparece cuando la configuración no declara ninguna lista. items: maxLength: 253 type: string maxItems: 100 type: array example: - api.clearsale.com.br allowedPrivateHosts: description: >- Hosts privados con nombre que esta configuración puede alcanzar, gestionados por tu equipo de operaciones. El campo no aparece cuando el conjunto está vacío. items: maxLength: 253 type: string maxItems: 100 type: array example: - nginx.pix-inline.internal config: additionalProperties: type: object description: Configuración específica del provider. example: baseUrl: https://api.clearsale.com.br environment: production type: object createdAt: description: Marca de tiempo de cuando se creó la configuración. example: '2026-03-17T14:00:00Z' format: date-time type: string description: description: Descripción legible por humanos. example: ClearSale anti-fraud for Pix transactions type: string id: description: Identificador único de la configuración. example: c3d4e5f6-a7b8-9012-cdef-345678901234 format: uuid type: string kind: description: >- Tipo de conexión de esta configuración: `catalog` apunta a un provider publicado en el catálogo, y `external_openapi` apunta a un documento OpenAPI registrado en tu tenant. enum: - catalog - external_openapi example: catalog type: string metadata: additionalProperties: type: object description: Metadatos personalizados. example: environment: production team: risk type: object name: description: Nombre de la configuración. example: ClearSale Production type: string providerId: description: >- ID del provider del catálogo al que apunta esta configuración. Una configuración de kind `external_openapi` creada sin uno lleva en su lugar el id reservado `external.openapi`. example: clearsale type: string schemaBindings: description: >- Esquemas almacenados a los que se vincula esta configuración. El campo siempre aparece, y es una lista vacía cuando la configuración no vincula ningún esquema. items: $ref: '#/components/schemas/SchemaBindingOutput' type: array status: description: 'Estado actual: `active` o `disabled`.' enum: - active - disabled example: active type: string updatedAt: description: Marca de tiempo de la última actualización. example: '2026-03-17T14:00:00Z' format: date-time type: string required: - config - createdAt - id - kind - name - providerId - schemaBindings - status - updatedAt 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 SchemaBindingInput: description: Un vínculo entre una configuración de provider y un esquema almacenado. properties: operations: description: >- Restringe un vínculo OpenAPI a las operaciones indicadas. Omítelo, o envía null, para vincular el documento completo. Solo un vínculo de tipo "openapi" acepta operaciones. items: $ref: '#/components/schemas/SchemaBindingOperationInput' maxItems: 100 type: - array - 'null' schemaId: description: Identificador del esquema almacenado, en formato UUID. example: 018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8 type: string type: description: Registro de esquemas al que apunta el vínculo. enum: - xsd - openapi example: openapi type: string required: - schemaId - type type: object SchemaBindingOutput: description: Un vínculo entre una configuración de provider y un esquema almacenado. properties: operations: description: >- Las operaciones a las que se restringe un vínculo OpenAPI. El campo no aparece cuando el vínculo cubre el documento completo. items: $ref: '#/components/schemas/SchemaBindingOperationOutput' type: array schemaId: description: Identificador del esquema almacenado, en formato UUID. example: 018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8 type: string type: description: Registro de esquemas al que apunta el vínculo. enum: - xsd - openapi example: openapi type: string required: - schemaId - type 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 SchemaBindingOperationInput: description: Una operación de un documento OpenAPI vinculado. properties: method: description: >- Método HTTP de la operación. Uno de GET, PUT, POST, DELETE, OPTIONS, HEAD, PATCH o TRACE. Flowker pasa el valor a mayúsculas. example: POST maxLength: 10 type: string path: description: Ruta de la operación. Debe empezar con una barra. example: /payments maxLength: 2048 type: string required: - method - path type: object SchemaBindingOperationOutput: description: Una operación de un documento OpenAPI vinculado. properties: method: description: Método HTTP de la operación, en mayúsculas. example: POST type: string path: description: Ruta de la operación. example: /payments type: string required: - method - path 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 `. ````