Sign in
Providers

Update a provider

Update an existing provider configuration. The provider key is required. All other fields are optional — omitted fields are cleared from the stored configuration (this is a full replacement, not a partial merge).

post/providers/{id}

Path parameters

idstring required

A unique identifier of the provider configuration to update.

Request body

providerstring required

The provider key identifying the type.

titlestring

Updated display title.

aliasstring

Updated alias. Omit to clear.

settingsobject

Provider-specific settings (snake_case keys). Replaces the full settings object — omitted settings fields are removed. Use the catalog endpoint to check required fields.

Response

idstring required

A unique identifier for the provider configuration.

titlestring required

Display title. Defaults to "Default Configuration" when not explicitly set.

providerstring required

The provider key (e.g. "sendgrid", "twilio", "slack").

aliasstring

Optional alias for this configuration.

settingsobject required

Provider-specific settings (snake_case keys on the wire).

createdinteger required

Unix timestamp (ms) of when the provider was created.

updatedinteger nullable

Unix timestamp (ms) of when the provider was last updated.

Changes