Tools

List Tools

Path Parameters

org_id*Org Id

Query Parameters

workspace_id?|

Workspace ID (for context/filtering)

category?|

Filter by category

status?|

Filter by status

search?|

Search query

include_disabled?Include Disabled

Include disabled tools

Defaultfalse

limit?Limit

Maximum number of items to return (1-200)

Default50

Range1 <= value <= 200

cursor?|

Cursor for pagination (from previous response's next_cursor)

Header Parameters

x-trace-id?string|null

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/tools"

{
  "total": 0,
  "has_more": false,
  "next_cursor": "string",
  "tools": [
    {
      "tool_id": "string",
      "name": "string",
      "slug": "string",
      "description": "string",
      "short_description": "string",
      "category": "string",
      "tags": [
        "string"
      ],
      "version": "string",
      "status": "string",
      "is_builtin": true,
      "icon_url": "string",
      "documentation_url": "string",
      "config_schema": [
        {}
      ],
      "credential_schema": [
        {}
      ],
      "supported_actions": [
        "string"
      ],
      "action_schemas": [
        {}
      ],
      "custom_action_type": "none",
      "is_mcp_compatible": false,
      "mcp_functions": [
        {}
      ],
      "supported_step_types": [
        "string"
      ],
      "current_schema_version": 1,
      "min_schema_version": 1,
      "schema_changelog": {
        "property1": "string",
        "property2": "string"
      },
      "supports_connection": false,
      "connection_service_name": "string",
      "author": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Create Tool

Path Parameters

org_id*Org Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*Name

Length1 <= length <= 100

slug*Slug

Match^[a-z0-9-]+$

Length1 <= length <= 50

description*Description

Length1 <= length <= 1000

short_description?|null

category?ToolCategory

Categories for organizing tools

Default"utilities"

Value in

"communication" | "data" | "ai" | "development" | "storage" | "utilities" | "monitoring" | "crm" | "productivity" | "custom"

tags?array<string>

icon_url?string|null

documentation_url?string|null

config_schema?array<>

credential_schema?array<>

supported_actions?array<string>

action_schemas?array<>

custom_action_type?Custom Action Type

Type of custom actions: 'none', 'custom_rest', or 'data_transform'

Default"none"

Response Body

`application/json`

curl -X POST "https://loading/v1/orgs/string/tools" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "slug": "string",    "description": "string"  }'

{
  "tool_id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "short_description": "string",
  "category": "string",
  "tags": [
    "string"
  ],
  "version": "string",
  "status": "string",
  "is_builtin": true,
  "icon_url": "string",
  "documentation_url": "string",
  "config_schema": [
    {}
  ],
  "credential_schema": [
    {}
  ],
  "supported_actions": [
    "string"
  ],
  "action_schemas": [
    {}
  ],
  "custom_action_type": "none",
  "is_mcp_compatible": false,
  "mcp_functions": [
    {}
  ],
  "supported_step_types": [
    "string"
  ],
  "current_schema_version": 1,
  "min_schema_version": 1,
  "schema_changelog": {
    "property1": "string",
    "property2": "string"
  },
  "supports_connection": false,
  "connection_service_name": "string",
  "author": "string",
  "created_at": "string",
  "updated_at": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Get Custom Action Schemas

Path Parameters

org_id*Org Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/tools/custom-action-schemas"

{
  "schemas": {
    "property1": {
      "type": "string",
      "description": "string",
      "example": {}
    },
    "property2": {
      "type": "string",
      "description": "string",
      "example": {}
    }
  },
  "custom_rest_schema": {
    "name": "string",
    "display_name": "string",
    "description": "string",
    "method": "GET",
    "url_template": "string",
    "headers": {
      "property1": "string",
      "property2": "string"
    },
    "body_template": "string",
    "query_params_template": {
      "property1": "string",
      "property2": "string"
    },
    "parameters": [
      {
        "name": "string",
        "display_name": "string",
        "type": "string",
        "required": false,
        "default": null,
        "description": "string",
        "placeholder": "string",
        "options": [
          {
            "property1": "string",
            "property2": "string"
          }
        ],
        "properties": {},
        "items": {},
        "min_length": 0,
        "max_length": 0,
        "min_value": 0,
        "max_value": 0,
        "pattern": "string",
        "enum": [
          null
        ],
        "multiline": false,
        "sensitive": false,
        "depends_on": "string"
      }
    ],
    "response_result_path": "string",
    "output_schema": {
      "type": "object",
      "description": "string",
      "properties": {},
      "items": {},
      "example": null
    },
    "pagination": {
      "type": "none",
      "cursor_param": "cursor",
      "cursor_response_path": "$.next_cursor",
      "offset_param": "offset",
      "limit_param": "limit",
      "default_limit": 100,
      "page_param": "page",
      "per_page_param": "per_page",
      "default_per_page": 100,
      "next_link_path": "string",
      "has_more_path": "string",
      "total_count_path": "string",
      "results_path": "$",
      "unique_key": "id",
      "max_pages": 100
    },
    "is_read_only": true,
    "is_destructive": false,
    "requires_confirmation": false,
    "timeout_seconds": 1,
    "retry_count": 0,
    "rate_limit_group": "string"
  },
  "data_transform_schema": {
    "name": "string",
    "display_name": "string",
    "description": "string",
    "transform_type": "chunk",
    "input_template": "{{input}}",
    "chunking": {
      "strategy": "tokens",
      "chunk_size": 500,
      "chunk_overlap": 50,
      "delimiter": "string",
      "tokenizer_model": "cl100k_base",
      "include_metadata": true
    },
    "field_mappings": {
      "property1": "string",
      "property2": "string"
    },
    "extract_patterns": [
      {
        "name": "string",
        "pattern": "string",
        "flags": "",
        "group": 0,
        "multiple": false,
        "default": "string"
      }
    ],
    "filter_conditions": [
      {
        "field": "string",
        "operator": "eq",
        "value": null
      }
    ],
    "filter_mode": "include",
    "flatten_template": "string",
    "flatten_depth": 1,
    "aggregate_operation": "string",
    "aggregate_separator": "\n",
    "output_schema": {},
    "output_template": "string",
    "parameters": [
      {
        "name": "string",
        "display_name": "string",
        "type": "string",
        "required": false,
        "default": null,
        "description": "string",
        "placeholder": "string",
        "options": [
          {
            "property1": "string",
            "property2": "string"
          }
        ],
        "properties": {},
        "items": {},
        "min_length": 0,
        "max_length": 0,
        "min_value": 0,
        "max_value": 0,
        "pattern": "string",
        "enum": [
          null
        ],
        "multiline": false,
        "sensitive": false,
        "depends_on": "string"
      }
    ]
  }
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Get Tool

Path Parameters

org_id*Org Id

tool_id*Tool Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/tools/string"

{
  "tool_id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "short_description": "string",
  "category": "string",
  "tags": [
    "string"
  ],
  "version": "string",
  "status": "string",
  "is_builtin": true,
  "icon_url": "string",
  "documentation_url": "string",
  "config_schema": [
    {}
  ],
  "credential_schema": [
    {}
  ],
  "supported_actions": [
    "string"
  ],
  "action_schemas": [
    {}
  ],
  "custom_action_type": "none",
  "is_mcp_compatible": false,
  "mcp_functions": [
    {}
  ],
  "supported_step_types": [
    "string"
  ],
  "current_schema_version": 1,
  "min_schema_version": 1,
  "schema_changelog": {
    "property1": "string",
    "property2": "string"
  },
  "supports_connection": false,
  "connection_service_name": "string",
  "author": "string",
  "created_at": "string",
  "updated_at": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Update Tool

Path Parameters

org_id*Org Id

tool_id*Tool Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?|null

description?|null

short_description?|null

category?|null

tags?array<string>|null

icon_url?string|null

documentation_url?string|null

status?|null

version?string|null

config_schema?array<>|null

credential_schema?array<>|null

supported_actions?array<string>|null

action_schemas?array<>|null

custom_action_type?|

Type of custom actions: 'none', 'custom_rest', or 'data_transform'

Response Body

`application/json`

curl -X PUT "https://loading/v1/orgs/string/tools/string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "tool_id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "short_description": "string",
  "category": "string",
  "tags": [
    "string"
  ],
  "version": "string",
  "status": "string",
  "is_builtin": true,
  "icon_url": "string",
  "documentation_url": "string",
  "config_schema": [
    {}
  ],
  "credential_schema": [
    {}
  ],
  "supported_actions": [
    "string"
  ],
  "action_schemas": [
    {}
  ],
  "custom_action_type": "none",
  "is_mcp_compatible": false,
  "mcp_functions": [
    {}
  ],
  "supported_step_types": [
    "string"
  ],
  "current_schema_version": 1,
  "min_schema_version": 1,
  "schema_changelog": {
    "property1": "string",
    "property2": "string"
  },
  "supports_connection": false,
  "connection_service_name": "string",
  "author": "string",
  "created_at": "string",
  "updated_at": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Get Tool By Slug

Path Parameters

org_id*Org Id

slug*Slug

Header Parameters

x-trace-id?string|null

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/tools/slug/string"

{
  "tool_id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "short_description": "string",
  "category": "string",
  "tags": [
    "string"
  ],
  "version": "string",
  "status": "string",
  "is_builtin": true,
  "icon_url": "string",
  "documentation_url": "string",
  "config_schema": [
    {}
  ],
  "credential_schema": [
    {}
  ],
  "supported_actions": [
    "string"
  ],
  "action_schemas": [
    {}
  ],
  "custom_action_type": "none",
  "is_mcp_compatible": false,
  "mcp_functions": [
    {}
  ],
  "supported_step_types": [
    "string"
  ],
  "current_schema_version": 1,
  "min_schema_version": 1,
  "schema_changelog": {
    "property1": "string",
    "property2": "string"
  },
  "supports_connection": false,
  "connection_service_name": "string",
  "author": "string",
  "created_at": "string",
  "updated_at": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

List Tool Instances

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

Query Parameters

tool_id?|

Filter by tool ID

active_only?Active Only

Only active instances

Defaultfalse

limit?Limit

Maximum number of items to return (1-200)

Default50

Range1 <= value <= 200

cursor?|

Cursor for pagination (from previous response's next_cursor)

Header Parameters

x-trace-id?string|null

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/workspaces/string/tool-instances"

{
  "total": 0,
  "has_more": false,
  "next_cursor": "string",
  "instances": [
    {
      "instance_id": "string",
      "tool_id": "string",
      "workspace_id": "string",
      "namespace_id": "string",
      "name": "string",
      "description": "string",
      "configuration": {},
      "has_credentials": true,
      "credential_refs": {
        "property1": "string",
        "property2": "string"
      },
      "credential_fields": [
        "string"
      ],
      "custom_action_parameters": {
        "property1": [
          {}
        ],
        "property2": [
          {}
        ]
      },
      "action_defaults": {
        "property1": {},
        "property2": {}
      },
      "auth_config": {},
      "custom_actions": [
        {}
      ],
      "is_active": true,
      "mcp_description_override": "string",
      "mcp_action_filter": [
        "string"
      ],
      "mcp_action_descriptions": {
        "property1": "string",
        "property2": "string"
      },
      "mcp_max_calls_per_turn": 0,
      "mcp_requires_confirmation": false,
      "mcp_parameter_overrides": {
        "property1": {
          "property1": {},
          "property2": {}
        },
        "property2": {
          "property1": {},
          "property2": {}
        }
      },
      "auth_mode": "vault",
      "connection_credentials": {
        "client_id": "string",
        "client_secret_vault_id": "string",
        "callback_url": "string",
        "scopes_override": [
          "string"
        ]
      },
      "connection_status": "string",
      "schema_version": 1,
      "upgrade_available": false,
      "latest_schema_version": 0,
      "schema_deprecated": false,
      "last_used_at": "string",
      "usage_count": 0,
      "created_by": "string",
      "created_at": "string",
      "updated_at": "string",
      "tool_name": "string",
      "tool_slug": "string",
      "tool_category": "string",
      "tool_icon_url": "string",
      "supported_step_types": [
        "string"
      ],
      "effective_action_schemas": [
        {}
      ],
      "tool_config_schema": [
        {
          "name": "string",
          "display_name": "string",
          "type": "string",
          "required": false,
          "default": null,
          "description": "string",
          "placeholder": "string",
          "options": [
            {
              "property1": "string",
              "property2": "string"
            }
          ],
          "validation": {},
          "widget": "string",
          "widget_options": {}
        }
      ]
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Create Tool Instance

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

tool_id*Tool Id

ID of the tool from library

name*Name

Length1 <= length <= 100

description?|null

namespace_id?|

DEPRECATED — namespace-level credential scoping is handled by credential_templates on steps. Kept for backward compatibility.

auth_mode?Auth Mode

Authentication mode: 'vault' (provide credential_refs) or 'connection' (managed OAuth/API key via namespace connections). Only tools with connection_config support 'connection' mode.

Default"vault"

configuration?

credential_refs?

Map of credential field names to vault secret IDs. Required when auth_mode is 'vault', ignored when 'connection'.

connection_credentials?|

OAuth app credentials for managed connection mode. Contains client_id, client_secret_vault_id, callback_url.

custom_action_parameters?

Custom parameters per action to extend base schema

action_defaults?

Default values for action parameters

auth_config?|

Authentication configuration for Custom REST tool

custom_actions?array<>

User-defined REST actions for Custom REST tool

is_active?Is Active

Defaulttrue

mcp_description_override?|null

mcp_action_filter?array<string>|null

mcp_action_descriptions?|null

mcp_max_calls_per_turn?|null

mcp_requires_confirmation?Mcp Requires Confirmation

Defaultfalse

mcp_parameter_overrides?|null

Response Body

`application/json`

curl -X POST "https://loading/v1/orgs/string/workspaces/string/tool-instances" \  -H "Content-Type: application/json" \  -d '{    "tool_id": "string",    "name": "string"  }'

{
  "instance_id": "string",
  "tool_id": "string",
  "workspace_id": "string",
  "namespace_id": "string",
  "name": "string",
  "description": "string",
  "configuration": {},
  "has_credentials": true,
  "credential_refs": {
    "property1": "string",
    "property2": "string"
  },
  "credential_fields": [
    "string"
  ],
  "custom_action_parameters": {
    "property1": [
      {}
    ],
    "property2": [
      {}
    ]
  },
  "action_defaults": {
    "property1": {},
    "property2": {}
  },
  "auth_config": {},
  "custom_actions": [
    {}
  ],
  "is_active": true,
  "mcp_description_override": "string",
  "mcp_action_filter": [
    "string"
  ],
  "mcp_action_descriptions": {
    "property1": "string",
    "property2": "string"
  },
  "mcp_max_calls_per_turn": 0,
  "mcp_requires_confirmation": false,
  "mcp_parameter_overrides": {
    "property1": {
      "property1": {},
      "property2": {}
    },
    "property2": {
      "property1": {},
      "property2": {}
    }
  },
  "auth_mode": "vault",
  "connection_credentials": {
    "client_id": "string",
    "client_secret_vault_id": "string",
    "callback_url": "string",
    "scopes_override": [
      "string"
    ]
  },
  "connection_status": "string",
  "schema_version": 1,
  "upgrade_available": false,
  "latest_schema_version": 0,
  "schema_deprecated": false,
  "last_used_at": "string",
  "usage_count": 0,
  "created_by": "string",
  "created_at": "string",
  "updated_at": "string",
  "tool_name": "string",
  "tool_slug": "string",
  "tool_category": "string",
  "tool_icon_url": "string",
  "supported_step_types": [
    "string"
  ],
  "effective_action_schemas": [
    {}
  ],
  "tool_config_schema": [
    {
      "name": "string",
      "display_name": "string",
      "type": "string",
      "required": false,
      "default": null,
      "description": "string",
      "placeholder": "string",
      "options": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "validation": {},
      "widget": "string",
      "widget_options": {}
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Get Tool Instance

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

instance_id*Instance Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/workspaces/string/tool-instances/string"

{
  "instance_id": "string",
  "tool_id": "string",
  "workspace_id": "string",
  "namespace_id": "string",
  "name": "string",
  "description": "string",
  "configuration": {},
  "has_credentials": true,
  "credential_refs": {
    "property1": "string",
    "property2": "string"
  },
  "credential_fields": [
    "string"
  ],
  "custom_action_parameters": {
    "property1": [
      {}
    ],
    "property2": [
      {}
    ]
  },
  "action_defaults": {
    "property1": {},
    "property2": {}
  },
  "auth_config": {},
  "custom_actions": [
    {}
  ],
  "is_active": true,
  "mcp_description_override": "string",
  "mcp_action_filter": [
    "string"
  ],
  "mcp_action_descriptions": {
    "property1": "string",
    "property2": "string"
  },
  "mcp_max_calls_per_turn": 0,
  "mcp_requires_confirmation": false,
  "mcp_parameter_overrides": {
    "property1": {
      "property1": {},
      "property2": {}
    },
    "property2": {
      "property1": {},
      "property2": {}
    }
  },
  "auth_mode": "vault",
  "connection_credentials": {
    "client_id": "string",
    "client_secret_vault_id": "string",
    "callback_url": "string",
    "scopes_override": [
      "string"
    ]
  },
  "connection_status": "string",
  "schema_version": 1,
  "upgrade_available": false,
  "latest_schema_version": 0,
  "schema_deprecated": false,
  "last_used_at": "string",
  "usage_count": 0,
  "created_by": "string",
  "created_at": "string",
  "updated_at": "string",
  "tool_name": "string",
  "tool_slug": "string",
  "tool_category": "string",
  "tool_icon_url": "string",
  "supported_step_types": [
    "string"
  ],
  "effective_action_schemas": [
    {}
  ],
  "tool_config_schema": [
    {
      "name": "string",
      "display_name": "string",
      "type": "string",
      "required": false,
      "default": null,
      "description": "string",
      "placeholder": "string",
      "options": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "validation": {},
      "widget": "string",
      "widget_options": {}
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Delete Tool Instance

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

instance_id*Instance Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Response Body

`application/json`

curl -X DELETE "https://loading/v1/orgs/string/workspaces/string/tool-instances/string"

Empty

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Update Tool Instance

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

instance_id*Instance Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?|null

description?|null

configuration?|null

credential_refs?|null

auth_mode?|

Authentication mode: 'vault' or 'connection'

connection_credentials?|

OAuth app credentials for managed connection mode

custom_action_parameters?|null

action_defaults?|null

auth_config?|null

custom_actions?array<>|null

is_active?boolean|null

mcp_description_override?|null

mcp_action_filter?array<string>|null

mcp_action_descriptions?|null

mcp_max_calls_per_turn?|null

mcp_requires_confirmation?boolean|null

mcp_parameter_overrides?|null

Response Body

`application/json`

curl -X PUT "https://loading/v1/orgs/string/workspaces/string/tool-instances/string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "instance_id": "string",
  "tool_id": "string",
  "workspace_id": "string",
  "namespace_id": "string",
  "name": "string",
  "description": "string",
  "configuration": {},
  "has_credentials": true,
  "credential_refs": {
    "property1": "string",
    "property2": "string"
  },
  "credential_fields": [
    "string"
  ],
  "custom_action_parameters": {
    "property1": [
      {}
    ],
    "property2": [
      {}
    ]
  },
  "action_defaults": {
    "property1": {},
    "property2": {}
  },
  "auth_config": {},
  "custom_actions": [
    {}
  ],
  "is_active": true,
  "mcp_description_override": "string",
  "mcp_action_filter": [
    "string"
  ],
  "mcp_action_descriptions": {
    "property1": "string",
    "property2": "string"
  },
  "mcp_max_calls_per_turn": 0,
  "mcp_requires_confirmation": false,
  "mcp_parameter_overrides": {
    "property1": {
      "property1": {},
      "property2": {}
    },
    "property2": {
      "property1": {},
      "property2": {}
    }
  },
  "auth_mode": "vault",
  "connection_credentials": {
    "client_id": "string",
    "client_secret_vault_id": "string",
    "callback_url": "string",
    "scopes_override": [
      "string"
    ]
  },
  "connection_status": "string",
  "schema_version": 1,
  "upgrade_available": false,
  "latest_schema_version": 0,
  "schema_deprecated": false,
  "last_used_at": "string",
  "usage_count": 0,
  "created_by": "string",
  "created_at": "string",
  "updated_at": "string",
  "tool_name": "string",
  "tool_slug": "string",
  "tool_category": "string",
  "tool_icon_url": "string",
  "supported_step_types": [
    "string"
  ],
  "effective_action_schemas": [
    {}
  ],
  "tool_config_schema": [
    {
      "name": "string",
      "display_name": "string",
      "type": "string",
      "required": false,
      "default": null,
      "description": "string",
      "placeholder": "string",
      "options": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "validation": {},
      "widget": "string",
      "widget_options": {}
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Test Tool Instance

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

instance_id*Instance Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

test_credentials?|

Temporary credentials for testing (not saved)

Response Body

`application/json`

curl -X POST "https://loading/v1/orgs/string/workspaces/string/tool-instances/string/test" \  -H "Content-Type: application/json" \  -d '{}'

{
  "success": true,
  "message": "string",
  "details": {},
  "latency_ms": 0
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Toggle Tool Instance

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

instance_id*Instance Id

`application/json`

curl -X POST "https://loading/v1/orgs/string/workspaces/string/tool-instances/string/toggle?is_active=true"

{
  "instance_id": "string",
  "tool_id": "string",
  "workspace_id": "string",
  "namespace_id": "string",
  "name": "string",
  "description": "string",
  "configuration": {},
  "has_credentials": true,
  "credential_refs": {
    "property1": "string",
    "property2": "string"
  },
  "credential_fields": [
    "string"
  ],
  "custom_action_parameters": {
    "property1": [
      {}
    ],
    "property2": [
      {}
    ]
  },
  "action_defaults": {
    "property1": {},
    "property2": {}
  },
  "auth_config": {},
  "custom_actions": [
    {}
  ],
  "is_active": true,
  "mcp_description_override": "string",
  "mcp_action_filter": [
    "string"
  ],
  "mcp_action_descriptions": {
    "property1": "string",
    "property2": "string"
  },
  "mcp_max_calls_per_turn": 0,
  "mcp_requires_confirmation": false,
  "mcp_parameter_overrides": {
    "property1": {
      "property1": {},
      "property2": {}
    },
    "property2": {
      "property1": {},
      "property2": {}
    }
  },
  "auth_mode": "vault",
  "connection_credentials": {
    "client_id": "string",
    "client_secret_vault_id": "string",
    "callback_url": "string",
    "scopes_override": [
      "string"
    ]
  },
  "connection_status": "string",
  "schema_version": 1,
  "upgrade_available": false,
  "latest_schema_version": 0,
  "schema_deprecated": false,
  "last_used_at": "string",
  "usage_count": 0,
  "created_by": "string",
  "created_at": "string",
  "updated_at": "string",
  "tool_name": "string",
  "tool_slug": "string",
  "tool_category": "string",
  "tool_icon_url": "string",
  "supported_step_types": [
    "string"
  ],
  "effective_action_schemas": [
    {}
  ],
  "tool_config_schema": [
    {
      "name": "string",
      "display_name": "string",
      "type": "string",
      "required": false,
      "default": null,
      "description": "string",
      "placeholder": "string",
      "options": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "validation": {},
      "widget": "string",
      "widget_options": {}
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Upgrade Tool Instance

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

instance_id*Instance Id

Header Parameters

x-trace-id?string|null

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

target_version?|

Target schema version. If None, upgrades to latest (current_schema_version).

Response Body

`application/json`

curl -X POST "https://loading/v1/orgs/string/workspaces/string/tool-instances/string/upgrade" \  -H "Content-Type: application/json" \  -d '{}'

{
  "instance_id": "string",
  "previous_version": 0,
  "new_version": 0,
  "migration_applied": true,
  "changelog": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

200application/json

422application/json

201application/json

422application/json

200application/json

422application/json

200application/json

422application/json

200application/json

422application/json

200application/json

422application/json

200application/json

422application/json

201application/json

422application/json

200application/json

422application/json

204

422application/json

200application/json

422application/json

200application/json

422application/json

200application/json

422application/json

200application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`