Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
Create a new private tool in the user's vault.

Create a new private tool in the user's vault.

Create a new private tool in the user's vault.

POST/api/tools
Body
namestringrequired
descriptionstring
docker_imagestringrequired
commandstring
categorystring
output_parameterstring
output_typeobject
inputsobject
source_urlstring | enum
doc_linkstring | enum
license_infoobjectrequired

Request

curl
curl -X POST https://trickest.io/api/tools \
  -H "Authorization: Bearer $TRICKEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

Responses

200Tool created successfully
idstringrequired
namestringrequired
descriptionstring
typeenumrequired

One of: TOOL, SCRIPT, MODULE

categorystring
authorstring
inputsobject[]
outputsobject[]
workflowstring
vaultstring
vault_infoobject
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

PreviousLibrary - ToolsList private tools for the current vault.Library - ToolsNextResolve a tool node