Skip to main content
PATCH
Update an Executor Configuration

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider. Send it in the Authorization header as Bearer <token>.

Parâmetros de caminho

id
string<uuid>
obrigatório

Unique identifier of the executor configuration.

Corpo

application/json

Request body containing the updated executor configuration details.

authentication
object
obrigatório
baseUrl
string
obrigatório

Base URL of the external service.

Maximum string length: 500
Exemplo:

"https://api.serasa.com.br/v2"

endpoints
object[]
obrigatório

List of HTTP endpoints exposed by this executor.

Minimum array length: 1
name
string
obrigatório

Display name for the executor configuration.

Required string length: 1 - 100
Exemplo:

"Serasa KYC"

description
string

Human-readable description of this executor configuration.

Maximum string length: 500
Exemplo:

"Serasa KYC provider for identity validation"

metadata
object

Custom key-value pairs for tagging.

Resposta

Indicates that the request was successful and the response contains the requested data.

authentication
object
baseUrl
string

Base URL of the external service.

Exemplo:

"https://api.serasa.com.br/v2"

createdAt
string<date-time>

Timestamp when the configuration was created.

Exemplo:

"2026-03-15T10:00:00Z"

description
string

Human-readable description.

Exemplo:

"Serasa identity validation service"

endpoints
object[]

List of configured HTTP endpoints.

id
string<uuid>

Unique identifier of the executor configuration.

Exemplo:

"b2c3d4e5-f6a7-8901-bcde-f23456789012"

lastTestedAt
string<date-time>

Timestamp when the configuration was last verified and ready for activation.

Exemplo:

"2026-03-16T09:15:00Z"

metadata
object

Custom metadata.

name
string

Display name.

Exemplo:

"Serasa KYC"

status
string

Current lifecycle status: unconfigured, configured, tested, active, or disabled.

Exemplo:

"active"

updatedAt
string<date-time>

Timestamp of the last update.

Exemplo:

"2026-03-16T09:30:00Z"