> ## 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 ejecutor > Utilice este endpoint para actualizar una configuración de ejecutor existente. Solo se pueden actualizar configuraciones con estado `unconfigured` o `configured`. ## OpenAPI ````yaml es/openapi/v3-current/flowker.yaml patch /v1/executors/{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 ejecutores, configuraciones de proveedores y ejecuciones de workflows. title: API de Flowker version: 1.1.1 servers: - url: https://flowker.sandbox.lerian.net security: - ApiKeyAuth: [] tags: - name: Catalog API description: >- Explore proveedores, ejecutores y disparadores integrados disponibles en el catálogo de Flowker. - name: Workflows API description: >- Cree, actualice, active, desactive, clone y elimine definiciones de workflows. - name: Executions API description: Inicie ejecuciones de workflows y rastree su estado y resultados. - name: Executor Configurations API description: >- Configure, pruebe y administre conexiones de ejecutores externos utilizadas por los nodos de workflow. - name: Provider Configurations API description: Configure, pruebe, habilite y deshabilite integraciones de proveedores. - name: Dashboard API description: >- Recupere resúmenes agregados de workflows y ejecuciones para dashboards operacionales. - name: Audit API description: >- Consulte y verifique eventos de auditoría para cumplimiento y visibilidad operacional. - name: Webhooks API description: >- Reciba callbacks de webhooks desde sistemas externos para disparar ejecuciones de workflows. paths: /v1/executors/{id}: patch: tags: - Executor Configurations API summary: Actualizar una configuración de ejecutor description: >- Utilice este endpoint para actualizar una configuración de ejecutor existente. Solo se pueden actualizar configuraciones con estado `unconfigured` o `configured`. operationId: updateExecutorConfiguration parameters: - description: Identificador único de la configuración del ejecutor. in: path name: id required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateExecutorConfigurationInput' description: >- Cuerpo de la solicitud que contiene los detalles actualizados de la configuración del ejecutor. required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExecutorConfigurationOutput' description: >- Indica que la solicitud fue exitosa y la respuesta contiene los datos solicitados. '400': content: application/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/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Indica que no se pudo encontrar el recurso solicitado. '422': content: application/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/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica un error interno inesperado. Si persiste, contacte al soporte. components: schemas: UpdateExecutorConfigurationInput: properties: authentication: $ref: '#/components/schemas/ExecutorAuthenticationInput' baseUrl: description: URL base del servicio externo. example: https://api.serasa.com.br/v2 maxLength: 500 type: string description: description: Descripción legible por humanos de esta configuración de ejecutor. example: Serasa KYC provider for identity validation maxLength: 500 type: string endpoints: description: Lista de endpoints HTTP expuestos por este ejecutor. items: $ref: '#/components/schemas/ExecutorEndpointInput' minItems: 1 type: array metadata: additionalProperties: type: object description: Pares clave-valor personalizados para etiquetado. type: object name: description: Nombre para mostrar de la configuración del ejecutor. example: Serasa KYC maxLength: 100 minLength: 1 type: string required: - authentication - baseUrl - endpoints - name type: object ExecutorConfigurationOutput: example: id: b2c3d4e5-f6a7-8901-bcde-f23456789012 name: Serasa KYC description: Serasa identity validation service baseUrl: https://api.serasa.com.br/v2 endpoints: - name: validate-identity path: /identity/validate method: POST timeout: 30 authentication: type: api_key config: key: '********' header: X-API-Key status: active metadata: {} createdAt: '2026-03-15T10:00:00Z' updatedAt: '2026-03-16T09:30:00Z' lastTestedAt: '2026-03-16T09:30:00Z' properties: authentication: $ref: '#/components/schemas/ExecutorAuthenticationOutput' baseUrl: description: URL base del servicio externo. example: https://api.serasa.com.br/v2 type: string createdAt: description: Marca de tiempo de cuando se creó la configuración. example: '2026-03-15T10:00:00Z' format: date-time type: string description: description: Descripción legible por humanos. example: Serasa identity validation service type: string endpoints: description: Lista de endpoints HTTP configurados. items: $ref: '#/components/schemas/ExecutorEndpointOutput' type: array id: description: Identificador único de la configuración del ejecutor. example: b2c3d4e5-f6a7-8901-bcde-f23456789012 format: uuid type: string lastTestedAt: description: >- Marca de tiempo de la última prueba de conectividad. Nulo si nunca se probó. example: '2026-03-16T09:30:00Z' format: date-time type: string metadata: additionalProperties: type: object description: Metadatos personalizados. type: object name: description: Nombre para mostrar. example: Serasa KYC type: string status: description: >- Estado actual del ciclo de vida: `unconfigured`, `configured`, `tested`, `active` o `disabled`. enum: - unconfigured - configured - tested - active - disabled example: active type: string updatedAt: description: Marca de tiempo de la última actualización. example: '2026-03-16T09:30:00Z' format: date-time type: string type: object ErrorResponse: properties: code: description: Código de error legible por máquina con el prefijo FLK. example: FLK-0001 type: string message: description: Explicación del error legible por humanos. example: Invalid input provided type: string title: description: Título corto de categoría de error. example: Bad Request type: string required: - code - message - title type: object ExecutorAuthenticationInput: properties: config: additionalProperties: type: object description: >- Parámetros de autenticación específicos del tipo elegido (ej., `key` para api_key, `token` para bearer, `username`/`password` para basic). example: key: sk-live-abc123def456 header: X-API-Key type: object type: description: >- Método de autenticación: `none`, `api_key`, `bearer`, `basic`, `oidc_client_credentials` u `oidc_user`. enum: - none - api_key - bearer - basic - oidc_client_credentials - oidc_user example: api_key type: string required: - type type: object ExecutorEndpointInput: properties: method: description: Método HTTP para este endpoint. enum: - GET - POST - PUT - PATCH - DELETE - HEAD - OPTIONS example: POST type: string name: description: Nombre único para este endpoint dentro del ejecutor. example: validate-identity maxLength: 50 minLength: 1 type: string path: description: Ruta URL añadida a la URL base del ejecutor. example: /identity/validate maxLength: 200 minLength: 1 type: string timeout: description: Tiempo de espera de la solicitud en segundos. Por defecto es 30. example: 30 maximum: 300 minimum: 1 type: integer required: - method - name - path type: object ExecutorAuthenticationOutput: properties: config: additionalProperties: type: object description: >- Parámetros de autenticación. Los valores sensibles están enmascarados. example: key: '********' header: X-API-Key type: object type: description: Método de autenticación. example: api_key type: string type: object ExecutorEndpointOutput: properties: method: description: Método HTTP. example: POST type: string name: description: Nombre del endpoint. example: validate-identity type: string path: description: Ruta URL. example: /identity/validate type: string timeout: description: Tiempo de espera de la solicitud en segundos. example: 30 type: integer type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Clave de API para autenticar las solicitudes a la API de Flowker. Se aprovisiona mediante la variable de entorno API_KEY durante el despliegue. ````