Update datasource in account

PUT /accounts/{account_externalid}/datasources/{datasource_guid}

Updates a datasource (connected application) in a customer account. Note: it's not possible to change the connector_guid (e.g. Salesforce) of an existing datasource.

Fields in response:

  • link: the URL to which the user should be redirected to authorize access to the datasource (e.g. Salesforce or Hubspot) for connectors that use oAuth. This link is valid for 30 minutes.
  • is_used: true if the datasource is used in a Blend. Note: a datasource can be loosely coupled, this means it is is used in a Blend but not specifically set under the datasource settings of the blocks in a Blend. In this case is_used will be false.
  • is_connected: false if the datasource is not connected, e.g. after a failed oAuth flow.
  • blends: The Blends using this datasource (hard linked, not soft-linked)

Path Parameters

Name Description Type
account_externalid string
datasource_guid string

Body Parameters

Name Description Type
name string
params array_object


  "name": "Salesforce connection",
  "params": [
      "api_key" : "12345"



  "guid": "fe35b720-0d53-11eb-b488-6f85f7dcde48",
  "name": "My Datasource name",
  "connector": {
    "guid": "0d86df6c-27c0-11ea-921c-022e6b5ea1e2",
    "name": "Teamleader"
  "is_used": false,
  "is_connected": false,
  "blends": [],
  "created_at": "2020-10-13T12:59:56.000000Z",
  "updated_at": "2020-10-13T12:59:56.000000Z",
  "additional": {
    "message": "This datasource requires user interaction to complete the setup.",
    "link": "https:\/\/admin.blendr.io\/datasources\/fe35b720-0d53-11eb-b488-6f85f7dcde48\/link?jwt=eyJ0eXAiOiJKV1QiL...dXJsIjpudWxsfQ.NzxuaD3W8fAPdkghzAeHpxmnf__ZDhfi_U9R7DscM1Q"