---
title: "Export Tool"
method: GET
path: "/workflows/v1/tools/{tool_id}/export"
tags: ["Tools"]
---

# Export Tool

`GET /workflows/v1/tools/{tool_id}/export`

Export a saved custom tool as a self-describing JSON bundle.

Identity/audit fields are stripped and secret-bearing fields (external_api
headers/body) are redacted; the recipient re-supplies them on import. Inbuilt
tools are not exportable.

## Path parameters

- `tool_id` string, required

## Response `200`

Successful Response

- ToolBundleExportResponse — Self-describing envelope for an exported custom tool. ``tool_config`` is a plain dict (not the ``ToolConfig`` model) so the ``<REDACTED>`` sentinels survive serialization instead of being coerced away by the discriminated union.
  - `export_format` string — Export format identifier
  - `source_tool_id` string, nullable — Original tool _id
  - `source_tool_name` string, nullable — Original tool name
  - `tool_type` string, nullable — ToolType of the exported tool (discriminator)
  - `tool_config` object, required — Sanitized ToolConfig as a dict (identity fields stripped, secrets redacted)
  - `redactions` ToolRedaction[] — Fields whose values were replaced with the '<REDACTED>' sentinel
    - `path` string, required — Dotted path to the redacted field, e.g. 'api_headers.Authorization'
    - `reason` string, required — Why it was redacted, e.g. 'sensitive header'
  - `required_dynamic_variables` string[] — Names of the dynamic/global variables this tool references. Values are team-scoped and are not carried in the bundle, so the importing team must define each name before the tool runs.
  - `exported_at` string, date-time — Timestamp of export
  - `warnings` string[] — Non-fatal notes (team-scoped refs cleared, env-specific endpoint, raw api_body, etc.)

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-24** `777675c8a285` — 1 info
  - added the optional property `required_dynamic_variables` to the response with the `200` status
- **2026-07-21** `d276be705570` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/interactly/apis/interactly-api-3/changes/workflows/v1/tools/:tool_id/export/get.md)

---

[API](https://skmtc.dev/interactly/apis/interactly-api-3.md) · [All operations](https://skmtc.dev/interactly/apis/interactly-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactly/interactly-api-3/revisions/35cbea12a781/schema)