Saltar al contenido principal
PATCH
/
v1
/
provider-configurations
/
{id}
Actualizar una configuración de proveedor
curl --request PATCH \
  --url https://flowker.sandbox.lerian.net/v1/provider-configurations/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "config": {},
  "description": "ClearSale anti-fraud — updated with new API version",
  "metadata": {},
  "name": "ClearSale Production v2"
}
'
{
  "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "name": "ClearSale Production",
  "description": "ClearSale anti-fraud for Pix transactions",
  "providerId": "clearsale",
  "config": {
    "baseUrl": "https://api.clearsale.com.br",
    "environment": "production"
  },
  "status": "active",
  "metadata": {
    "team": "risk"
  },
  "createdAt": "2026-03-17T14:00:00Z",
  "updatedAt": "2026-03-17T14:00:00Z"
}

Autorizaciones

X-API-Key
string
header
requerido

API key for authenticating requests to the Flowker API. Provisioned via the API_KEY environment variable during deployment.

Parámetros de ruta

id
string<uuid>
requerido

Identificador único de la configuración del proveedor.

Cuerpo

application/json

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

config
object

Configuración específica del proveedor actualizada.

description
string

Descripción actualizada.

Maximum string length: 500
Ejemplo:

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

metadata
object

Metadatos actualizados.

name
string

Nombre actualizado.

Required string length: 1 - 100
Ejemplo:

"ClearSale Production v2"

Respuesta

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

config
object

Configuración específica del proveedor.

Ejemplo:
{
"baseUrl": "https://api.clearsale.com.br",
"environment": "production"
}
createdAt
string<date-time>

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

Ejemplo:

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

description
string

Descripción legible por humanos.

Ejemplo:

"ClearSale anti-fraud for Pix transactions"

id
string<uuid>

Identificador único de la configuración.

Ejemplo:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

metadata
object

Metadatos personalizados.

Ejemplo:
{
"environment": "production",
"team": "risk"
}
name
string

Nombre de la configuración.

Ejemplo:

"ClearSale Production"

providerId
string

ID del proveedor del catálogo.

Ejemplo:

"clearsale"

status
enum<string>

Estado actual: active o disabled.

Opciones disponibles:
active,
disabled
Ejemplo:

"active"

updatedAt
string<date-time>

Marca de tiempo de la última actualización.

Ejemplo:

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