Preview agent update v1

curl --request PATCH \
  --url https://flow.seekr.com/v1/flow/agents/{agent_id}/diff \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Agent",
  "instructions": "You are a helpful assistant that can search files, browse the web, and run Python code.",
  "model_id": "deployment-123",
  "temperature": 0.4,
  "reasoning_effort": "medium",
  "tool_ids": [
    "tool-123",
    "tool-456"
  ]
}
'

{
  "before": {
    "id": "<string>",
    "name": "<string>",
    "instructions": "<string>",
    "user_id": "<string>",
    "team_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "model_id": "<string>",
    "planner_model_id": "<string>",
    "tool_model_id": "<string>",
    "output": {
      "instructions": "<string>",
      "model_id": "<string>",
      "temperature": 1
    },
    "temperature": 1,
    "planner_temperature": 1,
    "tools": [
      {
        "name": "<string>",
        "tool_env": {
          "FILE_SEARCH_INDEX": "<string>",
          "DOCUMENT_TOOL_DESC": "<string>",
          "EMBEDDING_MODEL": "<string>",
          "TOP_K": 10,
          "SCORE_THRESHOLD": 0
        },
        "id": "<string>"
      }
    ],
    "last_deployed_at": "2023-11-07T05:31:56Z",
    "active_duration": 0
  },
  "after": {
    "id": "<string>",
    "name": "<string>",
    "instructions": "<string>",
    "user_id": "<string>",
    "team_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "model_id": "<string>",
    "planner_model_id": "<string>",
    "tool_model_id": "<string>",
    "output": {
      "instructions": "<string>",
      "model_id": "<string>",
      "temperature": 1
    },
    "temperature": 1,
    "planner_temperature": 1,
    "tools": [
      {
        "name": "<string>",
        "tool_env": {
          "FILE_SEARCH_INDEX": "<string>",
          "DOCUMENT_TOOL_DESC": "<string>",
          "EMBEDDING_MODEL": "<string>",
          "TOP_K": 10,
          "SCORE_THRESHOLD": 0
        },
        "id": "<string>"
      }
    ],
    "last_deployed_at": "2023-11-07T05:31:56Z",
    "active_duration": 0
  },
  "diff": {}
}

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

PATCH

flow

agents

{agent_id}

diff

curl --request PATCH \
  --url https://flow.seekr.com/v1/flow/agents/{agent_id}/diff \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Agent",
  "instructions": "You are a helpful assistant that can search files, browse the web, and run Python code.",
  "model_id": "deployment-123",
  "temperature": 0.4,
  "reasoning_effort": "medium",
  "tool_ids": [
    "tool-123",
    "tool-456"
  ]
}
'

{
  "before": {
    "id": "<string>",
    "name": "<string>",
    "instructions": "<string>",
    "user_id": "<string>",
    "team_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "model_id": "<string>",
    "planner_model_id": "<string>",
    "tool_model_id": "<string>",
    "output": {
      "instructions": "<string>",
      "model_id": "<string>",
      "temperature": 1
    },
    "temperature": 1,
    "planner_temperature": 1,
    "tools": [
      {
        "name": "<string>",
        "tool_env": {
          "FILE_SEARCH_INDEX": "<string>",
          "DOCUMENT_TOOL_DESC": "<string>",
          "EMBEDDING_MODEL": "<string>",
          "TOP_K": 10,
          "SCORE_THRESHOLD": 0
        },
        "id": "<string>"
      }
    ],
    "last_deployed_at": "2023-11-07T05:31:56Z",
    "active_duration": 0
  },
  "after": {
    "id": "<string>",
    "name": "<string>",
    "instructions": "<string>",
    "user_id": "<string>",
    "team_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "model_id": "<string>",
    "planner_model_id": "<string>",
    "tool_model_id": "<string>",
    "output": {
      "instructions": "<string>",
      "model_id": "<string>",
      "temperature": 1
    },
    "temperature": 1,
    "planner_temperature": 1,
    "tools": [
      {
        "name": "<string>",
        "tool_env": {
          "FILE_SEARCH_INDEX": "<string>",
          "DOCUMENT_TOOL_DESC": "<string>",
          "EMBEDDING_MODEL": "<string>",
          "TOP_K": 10,
          "SCORE_THRESHOLD": 0
        },
        "id": "<string>"
      }
    ],
    "last_deployed_at": "2023-11-07T05:31:56Z",
    "active_duration": 0
  },
  "diff": {}
}

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

This endpoint is deprecated. Use PATCH /v2/flow/agents/{agent_id}/diff instead.

Authorizations

Authorization

string

header

required

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

Path Parameters

agent_id

string

required

Body

application/json

name

string | null

instructions

string | null

model_id

string | null

planner_model_id

string | null

tool_model_id

string | null

output

AgentOutputConfig · object | null

Optional configuration for the agent's final response. Overrides the top-level settings for response generation.

Show child attributes

temperature

number | null

Controls the predictability of the agent's reasoning. Accepts a value from 0 to 2. Defaults to 0.6. Lower values produce more consistent results, and higher values introduce more variation.

Required range: 0 <= x <= 2

tool_ids

string[] | null

reasoning_effort

enum<string> | null

Controls how much reasoning the agent uses when working through a request. Accepts low, medium, or high, where higher levels produce more thorough reasoning. The speed_optimized and performance_optimized values are only supported for backward compatibility. speed_optimized maps to low, and performance_optimized maps to high.

Available options:

low,

medium,

high,

speed_optimized,

performance_optimized

Response

Success

before

AgentSchema · object

required

Show child attributes

after

AgentSchema · object

required

Show child attributes

diff

Diff · object

Show child attributes

Last modified on July 31, 2026

⌘I

Overview

Endpoints

Preview agent update v1

Authorizations

Path Parameters

Body

Response