v6

latestOpenAPI 3.1.02026-08-04135335658.3 KB

Tools

Import Tool

Create a new tool from an exported bundle (see GET /tools/{tool_id}/export).

Re-injects redacted secrets from secret_overrides, resolves non-portable references, assigns a fresh identity to the importing team, and persists through the same validation path as create_tool.

post/workflows/v1/tools/import

Request body

name_overridestring nullable

Override for the imported tool's name

secret_overridesobject

Dotted-path -> value for each redacted field being re-supplied, e.g. {'api_headers.Authorization': 'Bearer ...'}

clear_unresolved_refsboolean

Clear team-scoped refs (KB ids) that cannot resolve in the importing team

confirm_executableboolean

Required True to import an inline_python tool (executable code)

Response

Successful Response

Example response

{
  "tool": {
    "_id": "5eb7cf5a86d9755df3a6c593"
  }
}