Preview tool update

curl --request PATCH \
  --url https://flow.seekr.com/v1/flow/tools/{tool_id}/diff \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my file search tool",
  "description": "contains files about ",
  "config": {
    "file_search_index": "my-document-index",
    "top_k": 10,
    "score_threshold": 0.7
  }
}
'

{
  "before": {
    "id": "<string>",
    "name": "<string>",
    "config": {
      "FILE_SEARCH_INDEX": "<string>",
      "EMBEDDING_MODEL": "<string>",
      "TOP_K": 10,
      "SCORE_THRESHOLD": 0
    },
    "user_id": "<string>",
    "team_id": "<string>",
    "status": "Active",
    "version": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "description": "<string>",
    "type": "file_search"
  },
  "after": {
    "id": "<string>",
    "name": "<string>",
    "config": {
      "FILE_SEARCH_INDEX": "<string>",
      "EMBEDDING_MODEL": "<string>",
      "TOP_K": 10,
      "SCORE_THRESHOLD": 0
    },
    "user_id": "<string>",
    "team_id": "<string>",
    "status": "Active",
    "version": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "description": "<string>",
    "type": "file_search"
  },
  "diff": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

PATCH

flow

tools

{tool_id}

diff

curl --request PATCH \
  --url https://flow.seekr.com/v1/flow/tools/{tool_id}/diff \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my file search tool",
  "description": "contains files about ",
  "config": {
    "file_search_index": "my-document-index",
    "top_k": 10,
    "score_threshold": 0.7
  }
}
'

{
  "before": {
    "id": "<string>",
    "name": "<string>",
    "config": {
      "FILE_SEARCH_INDEX": "<string>",
      "EMBEDDING_MODEL": "<string>",
      "TOP_K": 10,
      "SCORE_THRESHOLD": 0
    },
    "user_id": "<string>",
    "team_id": "<string>",
    "status": "Active",
    "version": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "description": "<string>",
    "type": "file_search"
  },
  "after": {
    "id": "<string>",
    "name": "<string>",
    "config": {
      "FILE_SEARCH_INDEX": "<string>",
      "EMBEDDING_MODEL": "<string>",
      "TOP_K": 10,
      "SCORE_THRESHOLD": 0
    },
    "user_id": "<string>",
    "team_id": "<string>",
    "status": "Active",
    "version": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "description": "<string>",
    "type": "file_search"
  },
  "diff": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Tool type cannot be changed after creation. If you include the type field in your request, it must match the existing tool type.

Authorizations

Authorization

string

header

required

Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.

Path Parameters

tool_id

string

required

Body

application/json

name

string | null

Maximum string length: 256

description

string | null

Maximum string length: 32768

type

enum<string> | null

Available options:

file_search,

web_search,

run_python,

agent_as_tool,

mcp_connector

config

Config · object | null

Response

Success

before

FileSearchResponse · object

required

FileSearchResponse
RunPythonResponse
WebSearchResponse
AgentAsToolResponse
MCPConnectorToolResponse

Show child attributes

after

FileSearchResponse · object

required

FileSearchResponse
RunPythonResponse
WebSearchResponse
AgentAsToolResponse
MCPConnectorToolResponse

Show child attributes

diff

Diff · object

Show child attributes

Last modified on July 31, 2026

⌘I

Overview

Endpoints

Preview tool update

Authorizations

Path Parameters

Body

Response