Skip to main content
Back to API List This API enables users to import configurations, datasets, or updates into an existing tool, allowing modifications without creating a new one. It ensures seamless integration by updating the tool with the provided tool data, flow data, and environment variables files. After triggering the import, the response returns a dockStatusId. Use this ID to call the Get Dock Status API and verify the status of the tool import process.
MethodPOST
Endpointhttps://{host}/api/public/tools/:{toolId}/import
Content Typeapplication/json
AuthorizationX-api-key - The API key used for authentication.
Where can I find the API key? To use the API, you will need an API key. Learn more.

​
Query Parameters

PARAMETERDESCRIPTIONTYPEREQUIRED/OPTIONAL
hostThe environment URL. For example, https://agent-platform.domain.ai/StringRequired
toolIdThe tool ID of the tool being importedStringRequired

​
Sample Request

curl --location 'https://{host}/api/public/tools/a-fbxxxxxf4-20x5-58xb-8b94-00xxxxxxxx5/import' 
--header 'x-api-key: kg-90xxxxx5-9xxe-5xxf-9xx7-9f4xxxxxxxx4-55xxxxx4-axx9-4xx2-axx2-fbcxxxxxxxxa' 
--header 'Content-Type: application/json' 
--data '{
    "toolDataFileId": "67xxxxxxxxxxxxxxxxxxxxxc",
    "flowDataFileId": "67xxxxxxxxxxxxxxxxxxxxxx2",
    "envVariablesFileId": "67xxxxxxxxxxxxxxxxxxxxx2"
}'

​
Body Parameters

PARAMETERDESCRIPTIONTYPEREQUIRED/OPTIONAL
toolDataFileIdThe identifier for the tool data file being imported.StringRequired
flowDataFileIdThe identifier for the flow data file.StringRequired
envVariablesFileIdThe identifier for the environment variables file.StringRequired

​
Sample Response

{
   "dockStatusId": "{dockStatusId}",
   "toolId": "{toolId}",
   "jobType": "TOOLS",
   "action": "IMPORT",
   "status": "SUCCESS"
}

​
Response Parameters

PARAMETERDESCRIPTIONTYPESAMPLE VALUE
dockStatusIdThe unique identifier to track the status of action. for example import, export, deploy, etc.Stringfor example, ds-c6xxxxx5-dxxd-5xxf-9xxd-0xxxxx6xxxx8
toolIdThe unique identifier for the tool.Stringfor example, a-8xxxxxbe-6xxe-5xx1-8xxc-bxxxxxx80xx6
jobTypeThe type of job being performed.StringTOOLS
actionThe action being performed on the tool/model.StringIMPORT
statusThe current status of the job.StringIN_PROGRESS, SUCCESS, or FAILED