Actualizar una configuración de provider

curl --request PATCH \
  --url https://flowker.sandbox.lerian.net/v1/provider-configurations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allowedHosts": [
    "api.acme.com",
    ".kyc-provider.io"
  ],
  "allowedPrivateHosts": [
    "nginx.pix-inline.internal"
  ],
  "config": {},
  "description": "ClearSale anti-fraud — updated with new API version",
  "metadata": {},
  "name": "ClearSale Production v2",
  "schemaBindings": [
    {
      "schemaId": "018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8",
      "type": "openapi",
      "operations": [
        {
          "method": "POST",
          "path": "/payments"
        }
      ]
    }
  ]
}
'

import requests

url = "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}"

payload = {
    "allowedHosts": ["api.acme.com", ".kyc-provider.io"],
    "allowedPrivateHosts": ["nginx.pix-inline.internal"],
    "config": {},
    "description": "ClearSale anti-fraud — updated with new API version",
    "metadata": {},
    "name": "ClearSale Production v2",
    "schemaBindings": [
        {
            "schemaId": "018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8",
            "type": "openapi",
            "operations": [
                {
                    "method": "POST",
                    "path": "/payments"
                }
            ]
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    allowedHosts: ['api.acme.com', '.kyc-provider.io'],
    allowedPrivateHosts: ['nginx.pix-inline.internal'],
    config: {},
    description: 'ClearSale anti-fraud — updated with new API version',
    metadata: {},
    name: 'ClearSale Production v2',
    schemaBindings: [
      {
        schemaId: '018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8',
        type: 'openapi',
        operations: [{method: 'POST', path: '/payments'}]
      }
    ]
  })
};

fetch('https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'allowedHosts' => [
        'api.acme.com',
        '.kyc-provider.io'
    ],
    'allowedPrivateHosts' => [
        'nginx.pix-inline.internal'
    ],
    'config' => [
        
    ],
    'description' => 'ClearSale anti-fraud — updated with new API version',
    'metadata' => [
        
    ],
    'name' => 'ClearSale Production v2',
    'schemaBindings' => [
        [
                'schemaId' => '018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8',
                'type' => 'openapi',
                'operations' => [
                                [
                                                                'method' => 'POST',
                                                                'path' => '/payments'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}"

	payload := strings.NewReader("{\n  \"allowedHosts\": [\n    \"api.acme.com\",\n    \".kyc-provider.io\"\n  ],\n  \"allowedPrivateHosts\": [\n    \"nginx.pix-inline.internal\"\n  ],\n  \"config\": {},\n  \"description\": \"ClearSale anti-fraud — updated with new API version\",\n  \"metadata\": {},\n  \"name\": \"ClearSale Production v2\",\n  \"schemaBindings\": [\n    {\n      \"schemaId\": \"018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8\",\n      \"type\": \"openapi\",\n      \"operations\": [\n        {\n          \"method\": \"POST\",\n          \"path\": \"/payments\"\n        }\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"allowedHosts\": [\n    \"api.acme.com\",\n    \".kyc-provider.io\"\n  ],\n  \"allowedPrivateHosts\": [\n    \"nginx.pix-inline.internal\"\n  ],\n  \"config\": {},\n  \"description\": \"ClearSale anti-fraud — updated with new API version\",\n  \"metadata\": {},\n  \"name\": \"ClearSale Production v2\",\n  \"schemaBindings\": [\n    {\n      \"schemaId\": \"018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8\",\n      \"type\": \"openapi\",\n      \"operations\": [\n        {\n          \"method\": \"POST\",\n          \"path\": \"/payments\"\n        }\n      ]\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"allowedHosts\": [\n    \"api.acme.com\",\n    \".kyc-provider.io\"\n  ],\n  \"allowedPrivateHosts\": [\n    \"nginx.pix-inline.internal\"\n  ],\n  \"config\": {},\n  \"description\": \"ClearSale anti-fraud — updated with new API version\",\n  \"metadata\": {},\n  \"name\": \"ClearSale Production v2\",\n  \"schemaBindings\": [\n    {\n      \"schemaId\": \"018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8\",\n      \"type\": \"openapi\",\n      \"operations\": [\n        {\n          \"method\": \"POST\",\n          \"path\": \"/payments\"\n        }\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

PATCH

provider-configurations

{id}

Actualizar una configuración de provider

curl --request PATCH \
  --url https://flowker.sandbox.lerian.net/v1/provider-configurations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allowedHosts": [
    "api.acme.com",
    ".kyc-provider.io"
  ],
  "allowedPrivateHosts": [
    "nginx.pix-inline.internal"
  ],
  "config": {},
  "description": "ClearSale anti-fraud — updated with new API version",
  "metadata": {},
  "name": "ClearSale Production v2",
  "schemaBindings": [
    {
      "schemaId": "018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8",
      "type": "openapi",
      "operations": [
        {
          "method": "POST",
          "path": "/payments"
        }
      ]
    }
  ]
}
'

import requests

url = "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}"

payload = {
    "allowedHosts": ["api.acme.com", ".kyc-provider.io"],
    "allowedPrivateHosts": ["nginx.pix-inline.internal"],
    "config": {},
    "description": "ClearSale anti-fraud — updated with new API version",
    "metadata": {},
    "name": "ClearSale Production v2",
    "schemaBindings": [
        {
            "schemaId": "018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8",
            "type": "openapi",
            "operations": [
                {
                    "method": "POST",
                    "path": "/payments"
                }
            ]
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    allowedHosts: ['api.acme.com', '.kyc-provider.io'],
    allowedPrivateHosts: ['nginx.pix-inline.internal'],
    config: {},
    description: 'ClearSale anti-fraud — updated with new API version',
    metadata: {},
    name: 'ClearSale Production v2',
    schemaBindings: [
      {
        schemaId: '018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8',
        type: 'openapi',
        operations: [{method: 'POST', path: '/payments'}]
      }
    ]
  })
};

fetch('https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'allowedHosts' => [
        'api.acme.com',
        '.kyc-provider.io'
    ],
    'allowedPrivateHosts' => [
        'nginx.pix-inline.internal'
    ],
    'config' => [
        
    ],
    'description' => 'ClearSale anti-fraud — updated with new API version',
    'metadata' => [
        
    ],
    'name' => 'ClearSale Production v2',
    'schemaBindings' => [
        [
                'schemaId' => '018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8',
                'type' => 'openapi',
                'operations' => [
                                [
                                                                'method' => 'POST',
                                                                'path' => '/payments'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}"

	payload := strings.NewReader("{\n  \"allowedHosts\": [\n    \"api.acme.com\",\n    \".kyc-provider.io\"\n  ],\n  \"allowedPrivateHosts\": [\n    \"nginx.pix-inline.internal\"\n  ],\n  \"config\": {},\n  \"description\": \"ClearSale anti-fraud — updated with new API version\",\n  \"metadata\": {},\n  \"name\": \"ClearSale Production v2\",\n  \"schemaBindings\": [\n    {\n      \"schemaId\": \"018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8\",\n      \"type\": \"openapi\",\n      \"operations\": [\n        {\n          \"method\": \"POST\",\n          \"path\": \"/payments\"\n        }\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"allowedHosts\": [\n    \"api.acme.com\",\n    \".kyc-provider.io\"\n  ],\n  \"allowedPrivateHosts\": [\n    \"nginx.pix-inline.internal\"\n  ],\n  \"config\": {},\n  \"description\": \"ClearSale anti-fraud — updated with new API version\",\n  \"metadata\": {},\n  \"name\": \"ClearSale Production v2\",\n  \"schemaBindings\": [\n    {\n      \"schemaId\": \"018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8\",\n      \"type\": \"openapi\",\n      \"operations\": [\n        {\n          \"method\": \"POST\",\n          \"path\": \"/payments\"\n        }\n      ]\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"allowedHosts\": [\n    \"api.acme.com\",\n    \".kyc-provider.io\"\n  ],\n  \"allowedPrivateHosts\": [\n    \"nginx.pix-inline.internal\"\n  ],\n  \"config\": {},\n  \"description\": \"ClearSale anti-fraud — updated with new API version\",\n  \"metadata\": {},\n  \"name\": \"ClearSale Production v2\",\n  \"schemaBindings\": [\n    {\n      \"schemaId\": \"018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8\",\n      \"type\": \"openapi\",\n      \"operations\": [\n        {\n          \"method\": \"POST\",\n          \"path\": \"/payments\"\n        }\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

Autorizaciones

Authorization

string

header

requerido

Token bearer JWT emitido por el provider de identidad. Envíalo en la cabecera Authorization como Bearer <token>.

Parámetros de ruta

string<uuid>

requerido

Identificador único de la configuración de provider.

Cuerpo

application/json

Cuerpo de la solicitud que contiene los detalles actualizados de la configuración de provider.

allowedHosts

string[]

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.

Maximum array length: 100

Maximum string length: 253

Ejemplo:

["api.acme.com", ".kyc-provider.io"]

allowedPrivateHosts

string[]

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.

Maximum array length: 100

Maximum string length: 253

Ejemplo:

["nginx.pix-inline.internal"]

config

object

Configuración específica del provider actualizada.

Show child attributes

description

string

Descripción actualizada.

Maximum string length: 500

Ejemplo:

"ClearSale anti-fraud — updated with new API version"

metadata

object

Metadatos actualizados.

Show child attributes

name

string

Nombre actualizado.

Required string length: 1 - 100

Ejemplo:

"ClearSale Production v2"

schemaBindings

object[]

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.

Maximum array length: 100

Show child attributes

Respuesta

Indica que la solicitud fue exitosa y la respuesta contiene los datos solicitados.

config

object

requerido

Configuración específica del provider.

Show child attributes

Ejemplo:

{
  "baseUrl": "https://api.clearsale.com.br",
  "environment": "production"
}

createdAt

string<date-time>

requerido

Marca de tiempo de cuando se creó la configuración.

Ejemplo:

"2026-03-17T14:00:00Z"

string<uuid>

requerido

Identificador único de la configuración.

Ejemplo:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

kind

enum<string>

requerido

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.

Opciones disponibles:

catalog,

external_openapi

Ejemplo:

"catalog"

name

string

requerido

Nombre de la configuración.

Ejemplo:

"ClearSale Production"

providerId

string

requerido

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.

Ejemplo:

"clearsale"

schemaBindings

object[]

requerido

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.

Show child attributes

status

enum<string>

requerido

Estado actual: active o disabled.

Opciones disponibles:

active,

disabled

Ejemplo:

"active"

updatedAt

string<date-time>

requerido

Marca de tiempo de la última actualización.

Ejemplo:

"2026-03-17T14:00:00Z"

allowedHosts

string[]

Lista de hosts de destino permitidos para las llamadas salientes. El campo no aparece cuando la configuración no declara ninguna lista.

Maximum array length: 100

Maximum string length: 253

Ejemplo:

["api.clearsale.com.br"]

allowedPrivateHosts

string[]

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.

Maximum array length: 100

Maximum string length: 253

Ejemplo:

["nginx.pix-inline.internal"]

description

string

Descripción legible por humanos.

Ejemplo:

"ClearSale anti-fraud for Pix transactions"

metadata

object

Metadatos personalizados.

Show child attributes

Ejemplo:

{
  "environment": "production",
  "team": "risk"
}

⌘I

Primeros pasos

API de Catálogo

API de Workflows

API de Programación

API de Ejecuciones

API de Dashboards

API de Configuraciones de Executor

API de Configuraciones de Provider

API de Registro de Esquemas

API de Esquemas OpenAPI

API de Esquemas XSD

API de Webhooks

Manejo de errores

Actualizar una configuración de provider

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta