Update connector

PATCH /api/connectors/{id}
OAuth2

Update connector by ID with the given data. This methods performs a partial update.

Path parameters

  • id string Required

    The unique identifier of the connector.

application/json

Body Required

  • config object

    The connector config object that will be passed to the connector. The config object should be compatible with the connector factory.

    Additional properties are allowed.

  • metadata object

    Custom connector metadata, will be used to overwrite the default connector metadata.

    Additional properties are allowed.

    Hide metadata attributes Show metadata attributes object
  • syncProfile boolean

    Whether to sync user profile from the identity provider to Logto at each sign-in. If false, the user profile will only be synced when the user is created.

Responses

PATCH /api/connectors/{id} 
curl \
 -X PATCH https://[tenant_id].logto.app/api/connectors/{id} \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"config":{},"metadata":{"target":"string","name":{},"logo":"string","logoDark":"string"},"syncProfile":true}'
Request examples 
{
  "config": {},
  "metadata": {
    "target": "string",
    "name": {},
    "logo": "string",
    "logoDark": "string"
  },
  "syncProfile": true
}
Response examples (200) 
{
  "id": "string",
  "syncProfile": true,
  "config": {},
  "metadata": {
    "target": "string",
    "name": {},
    "logo": "string",
    "logoDark": "string"
  },
  "connectorId": "string",
  "target": "string",
  "name": {},
  "description": {},
  "logo": "string",
  "logoDark": "string",
  "readme": "string",
  "configTemplate": "string",
  "formItems": [
    {
      "type": "string",
      "selectItems": [
        {
          "value": "string",
          "title": "string"
        }
      ],
      "key": "string",
      "label": "string",
      "placeholder": "string",
      "required": true,
      "showConditions": [
        {
          "targetKey": "string"
        }
      ],
      "description": "string",
      "tooltip": "string",
      "isConfidential": true
    }
  ],
  "customData": {},
  "fromEmail": "string",
  "platform": "Native",
  "isStandard": true,
  "type": "Email",
  "isDemo": true,
  "extraInfo": {},
  "usage": 42.0
}