Update connector
PUT/integrations/connectors/{id}
Updates an existing connector account's configuration or credentials. Omitting config_json or credentials_json preserves existing values. Use this to rotate credentials or update scopes without recreating the connector.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Integer ID of the connector to update. Example: |
Request body
Content type application/json (required).
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Connector display name. Max length: 120 |
key | string, nullable | No | Optional machine key; auto-derived if omitted. Max length: 80 |
type | string | Yes | External system category. One of: |
auth_type | string | Yes | Authentication mechanism. One of: |
status | string | No | Operational status. One of: |
config_json | string, nullable | No | JSON-encoded non-sensitive configuration object. |
credentials_json | string, nullable | No | JSON-encoded sensitive credentials object (write-only, stored encrypted). |
Example
{
"name": "Salesforce CRM",
"type": "crm",
"auth_type": "oauth2",
"status": "active",
"credentials_json": "{\"client_id\":\"NEW_CLIENT_ID\",\"client_secret\":\"NEW_SECRET\"}"
}Responses
302 Redirect to connectors list after update
404 Connector not found
422 Validation error
Example request
curl -X PUT "https://{tenant}.faciotech.net/api/v1/integrations/connectors/{id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"name": "Salesforce CRM", "type": "crm", "auth_type": "oauth2", "status": "active", "credentials_json": "{\"client_id\":\"NEW_CLIENT_ID\",\"client_secret\":\"NEW_SECRET\"}"}'