Get Data Source Upload Url
get_data_source_upload_urlGenerates a short-lived pre-signed URL for uploading a file that a Cutover data source reads, such as a CMDB export. Upload the raw file to the returned URL before it expires.
Instructions
Get a short-lived, pre-signed URL for uploading a file that a data source reads from, such as a CMDB export in JSON or CSV.
This server cannot read files on your machine, so upload the file yourself, straight away: send an HTTP PUT with the raw file as the body to the returned url before it expires (expires_in seconds). For example:
curl --fail -X PUT --upload-file ./cmdb.csv "<url>"Keep the url in double quotes, because it contains & characters the shell would otherwise split on. Keep --fail, so a rejected upload exits with an error instead of looking like a success. If the upload fails or the url has expired, call this tool again for a new url rather than reusing the old one.
For a new data source, create it with datasource_endpoint_url as its url. The file is scanned for malware after upload, so test the data source can read it before importing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_name": "<file_name>"
},
"name": "get_data_source_upload_url"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_name | Yes | Name of the file to upload, e.g. "cmdb.csv". Used to build the storage key. | |
| data_source_id | No | Omit for the first upload, before the data source exists. To upload a new version of the file behind an existing data source, pass that data source's ID. The new file only replaces the old one if the returned datasource_endpoint_url is the data source's current url; if it differs, the data source will not read this upload until its url is changed to the returned one. After uploading, refresh and sync the data source to pick up the changes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||