This API deploys a specific tool into an environment. It allows the user to control the deployment process either synchronously or asynchronously, depending on the value of the isAsync parameter.
The API response includes the tool ID and the tool deployment status. After receiving the response, use the dockStatusId to call the Get Dock Status API and verify the tool deployment status.
| Method
|
POST
|
| Endpoint
|
https://{host}/api/public/tools/:{toolId}/deploy
|
| Content Type
|
application/json
|
| Authorization
|
X-api-key - The API key used for authentication.
|
Where can I find the API key? Learn more.
Path Parameters
| PARAMETER
|
DESCRIPTION
|
TYPE
|
REQUIRED/OPTIONAL
|
| host
|
The environment URL. For example, https://agent-platform.domain.ai/
|
String
|
Required
|
| toolId
|
The unique identifier of the tool being deployed.
|
String
|
Required
|
Sample Request
curl --location 'https://{host}/api/public/tools/a-0xxxxxxxxxxxxxxxxxxe/deploy' \
--header 'x-api-key: kg-axxxxxxx-5xx3-5xx8-bxxb-9xxxxxxxxxxxb-9xx5-cxxxxxxxxx3' \
--header 'Content-Type: application/json' \
--data '{
"isAsync": false
}'
Body Parameters
| PARAMETER
|
DESCRIPTION
|
TYPE
|
REQUIRED/OPTIONAL
|
| isAsync
|
Indicates if the deployment is asynchronous (true) or synchronous (false).
|
Boolean
|
Required
|
Sample Response
{
"dock-statusId": "ds-cxxxxxx8-exx2-5xx7-9xx6-30xxxxxxxxxe",
"toolId": "a-49xxxxx9-fxx9-5xx7-axx7-9xxxxxxxxxxb",
"jobType": "TOOLS",
"action": "DEPLOY",
"status": "SUCCESS"
}
Response Parameters
| PARAMETER
|
DESCRIPTION
|
TYPE
|
| dockStatusId
|
The unique identifier for tracking the tool deployment.
|
String
|
| toolId
|
The unique identifier of the tool being deployed.
|
String
|
| jobType
|
The type of job being performed (“TOOLS”).
|
String
|
| action
|
The action being performed ("DEPLOY").
|
String
|
| status
|
The deployment status ("SUCCESS", "IN_PROGRESS", or "FAILED").
|
String
|