Update a datasource
PUT/api/v1/datasources/{id}
Updates a profile after EDIT permission. Omitted or blank security inputs preserve stored encrypted values; clearSecurityKeys explicitly removes named values. CSRF is required.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Datasource identifier.
Request Bodyrequired
Section titled “Request Bodyrequired”Request for a managed datasource profile. Unknown fields are rejected.
object
Security keys to remove explicitly during an update.
Example
[ "password"]Registered connector wire name.
Example
postgresUnique display name.
Example
Warehouse sourceSecurity values to encrypt. On update, omitted or blank entries preserve stored values.
object
Security values to encrypt. On update, omitted or blank entries preserve stored values.
Non-secret connector settings. Omitted values default to an empty map.
object
Non-secret connector settings. Omitted values default to an empty map.
Responses
Section titled “Responses”Datasource updated
Redacted managed datasource profile and permission-aware capabilities.
object
Whether the current identity may edit this profile.
Whether the current identity may bind this profile to a job.
Whether the current identity may view this profile.
Role-specific connector capabilities used to validate job bindings.
object
Whether the connector requires jobs=1.
Whether the connector can receive sink rows.
Whether the connector can provide source rows.
Whether source.query is supported.
Registered connector wire name.
Creation timestamp in UTC.
Datasource identifier.
Datasource display name.
Credential-redacted connection display suitable for the UI.
Whether encrypted security material is configured, without exposing it.
Non-secret connector settings.
object
Non-secret connector settings.
Last update timestamp in UTC.
The request is malformed or fails validation.
RFC 7807 problem response. Dynamic detail text is credential-redacted.
object
Authentication is required or credentials are invalid.
RFC 7807 problem response. Dynamic detail text is credential-redacted.
object
The authenticated identity lacks the required permission.
RFC 7807 problem response. Dynamic detail text is credential-redacted.
object
The requested resource does not exist or is not visible.
RFC 7807 problem response. Dynamic detail text is credential-redacted.
object
The request conflicts with the current resource or run state.
RFC 7807 problem response. Dynamic detail text is credential-redacted.