Skip to main content
PATCH
/
v1
/
providers
/
{id}
Update a Provider
curl --request PATCH \
  --url https://identity.sandbox.lerian.net/v1/providers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "sendgrid-primary-v2",
  "host": "smtp.sendgrid.net",
  "port": 465,
  "disableSsl": true
}
'
{
  "id": "019c96a0-1a10-7abc-d1e2-8c9d0e1f2a3b",
  "name": "sendgrid-primary-v2",
  "category": "Email",
  "type": "SendGrid",
  "host": "smtp.sendgrid.net",
  "port": 465,
  "disableSsl": true,
  "createdAt": "2025-04-08T08:01:30.000Z"
}

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.

Authorizations

​
Authorization
string
header
required

The authorization token in the 'Bearer ' format.

Path Parameters

​
id
string
required

The unique identifier of the provider.

Body

application/json

Information used to update an existing provider. Note that category and type are immutable after creation.

​
name
string

Updated name for the provider.

​
clientId
string

Updated client ID or API key.

​
clientSecret
string

Updated client secret or API secret.

​
host
string

Updated SMTP or API host address.

​
port
integer

Updated SMTP port.

​
disableSsl
boolean

Updated SSL/TLS setting.

Response

Indicates that the provider was successfully updated and the operation was completed as expected.

Information about a communication provider.

​
id
string

Unique identifier of the provider.

​
name
string

Name of the provider.

​
category
enum<string>

Provider category.

Available options:
Email,
SMS
​
type
enum<string>

Provider implementation type.

Available options:
SendGrid,
Twilio
​
subType
string

Provider sub-type, if applicable.

​
method
string

Authentication or delivery method.

​
clientId
string

Client ID or API key (secret is never returned).

​
clientId2
string

Secondary client ID, if applicable.

​
host
string

SMTP or API host address.

​
port
integer

SMTP port.

​
disableSsl
boolean

Indicates whether SSL/TLS is disabled.

​
title
string

Default email or SMS title/subject.

​
content
string

Default message content template.

​
receiver
string

Default receiver address for testing.

​
regionId
string

Cloud region ID (provider-specific).

​
signName
string

SMS signature name (provider-specific).

​
templateCode
string

SMS template code (provider-specific).

​
appId
string

Application ID (provider-specific).

​
endpoint
string

Provider API endpoint URL.

​
intranetEndpoint
string

Intranet endpoint for private network access.

​
domain
string

Provider domain.

​
providerUrl
string

Provider-specific URL.

​
createdAt
string<date-time>

Timestamp marking when the provider was created.