Update Datasource

Description

This service is used to update a partner datasource for the authenticated user.

---

Request

Restrictions

This service requires an authenticated user and can only be called after a successful partner login.

Endpoint

PUT https://<server-url>/api/v4/partner/datasources/{datasource_id}

Parameters

Parameter	Location	Description
touchpoint	Query / Header	The authentication token for the API session. Use Thalamus-Token for the header.
token	Query / Header	The authentication token for the API session. Use Thalamus-Token for the header.
datasource_id	Query / Header	The ID of the datasource to be modified.

Full URL Example

https://<server-url>/api/v4/partner/datasources/14?touchpoint=test&token=...

Request Body

The request body must be a JSON object with the following fields:

Field	Type	Required	Description
host	string	Yes	The host URL for the datasource (e.g., "test.myftp.net").
user	string	Yes	The username for the datasource.
password	string	Yes	The password for the user.
workingDirectory	string	Yes	The remote working directory on the host (e.g., "/stock").
processorType	integer	Yes	The data processor type. Supported values are: 25006 (Physical location), 25004 (Company), 25011 (Partner Sales), 25012 (Partner Stock), 25000 (Person Import).
fileImportType	string	No	The type of file to be imported. Supported values: PARTY, PRINCIPAL.
authenticationType	string	Yes	The authentication method. Supported values: PASSWORD, CERTIFICATE.
dataSourceType	string	Yes	The type of datasource. Supported values: FTP, SFTP,S3.
touchpointCode	string	Yes	The touchpoint code associated with the datasource.
amountCalculated	boolean	No	According to datasource for extra calculation

JSON

{
  "host": "test.myftp.net",
  "user": "demo",
  "password": "password",
  "workingDirectory": "/stock",
  "processorType": 25012,
  "fileImportType": "PARTY",
  "authenticationType": "PASSWORD",
  "dataSourceType": "FTP",
  "touchpointCode": "test",
  "amountCalculated": true
}

---

Response

✅ Successful Response: 200 Ok

• HTTP Status Code: 200 Ok

• Body: A JSON object confirming the successful update of the datasource.

Example Response

JSON

{
  "context": {
    "links": [
      {
        "ref": "home",
        "href": "http://localhost:8080/thalamus/api/v3/people/home"
      }
    ],
    "activities": [],
    "simpleProfile": {
      "firstname": null,
      "lastname": null,
      "email": null,
      "shortName": null,
      "longName": null,
      "me": false,
      "urlAvatar": ""
    }
  },
  "datasource": {
    "id": 1,
    "host": "test.myftp.net",
    "user": "demo",
    "password": "password",
    "workingDirectory": "/stock",
    "processorType": 25012,
    "fileImportType": "PARTY",
    "dataSourceType": "FTP",
    "touchpointCode": "test",
    "authenticationType": "PASSWORD",
    "touchpointCode": "REST02",
    "active": true,
    "privateKeyFile": null,
    "passphrase": null,
    "region": null,
    "reprocessingDays": null,
    "lastRunningTime": null,
    "amountCalculated": true
  }
}

❌ Unsuccessful Response: 400 Bad Request

• HTTP Status Code: 400 Bad Request

• Body: A JSON object containing details about the error.

Example Response

JSON

{
  "errors": {
    "partnerDataSource": "TouchpointCodeRequired",
    "partnerDataSource": "InvalidTouchpointCode"
  }
}