> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seekr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Promote agent v1

> Promote an agent to active status so it can serve requests.

Activate an agent so it can handle inference requests. Agents are automatically promoted on creation—this endpoint is only needed after an agent has been demoted.

When promoting an agent that has sub-agents linked as tools, SeekrFlow automatically promotes the sub-agents first. The supervisor remains in `Pending` state until all sub-agents are ready.


## OpenAPI

````yaml put /v1/flow/agents/{agent_id}/promote
openapi: 3.1.0
info:
  title: SeekrFlow API
  description: SeekrFlow API Documentation
  termsOfService: http://www.seekr.com/support
  contact:
    name: Seekr API Support
    url: http://www.seekr.com/contact
    email: contact@seekr.com
  version: 5.99.0
servers:
  - url: https://flow.seekr.com
    description: SeekrBuild server base URL
security: []
paths:
  /v1/flow/agents/{agent_id}/promote:
    put:
      tags:
        - Agents
      summary: Promote agent v1
      description: Promote an agent to active status so it can serve requests.
      operationId: promote_v1_flow_agents__agent_id__promote_put
      parameters:
        - name: agent_id
          in: path
          required: true
          schema:
            type: string
            title: Agent Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSchema'
        '422':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    AgentSchema:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        instructions:
          type: string
          title: Instructions
        status:
          $ref: '#/components/schemas/AgentStatus'
        model_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Model Id
        output:
          anyOf:
            - $ref: '#/components/schemas/AgentOutputConfig'
            - type: 'null'
        temperature:
          anyOf:
            - type: number
              maximum: 2
              minimum: 0
            - type: 'null'
          title: Temperature
        reasoning_effort:
          $ref: '#/components/schemas/ReasoningEffort'
        planner_temperature:
          anyOf:
            - type: number
              maximum: 2
              minimum: 0
            - type: 'null'
          title: Planner Temperature
        user_id:
          type: string
          title: User Id
        team_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Team Id
        tools:
          items:
            oneOf:
              - $ref: >-
                  #/components/schemas/llm_training__agents__tools__schemas__file_search__FileSearch
              - $ref: >-
                  #/components/schemas/llm_training__agents__tools__schemas__web_search__WebSearch
              - $ref: >-
                  #/components/schemas/llm_training__agents__tools__schemas__run_python__RunPython
              - $ref: >-
                  #/components/schemas/llm_training__agents__tools__schemas__agent_as_tool__AgentAsTool
              - $ref: >-
                  #/components/schemas/llm_training__agents__tools__schemas__mcp_connector__MCPConnectorTool
            discriminator:
              propertyName: name
              mapping:
                agent_as_tool:
                  $ref: >-
                    #/components/schemas/llm_training__agents__tools__schemas__agent_as_tool__AgentAsTool
                file_search:
                  $ref: >-
                    #/components/schemas/llm_training__agents__tools__schemas__file_search__FileSearch
                mcp_connector:
                  $ref: >-
                    #/components/schemas/llm_training__agents__tools__schemas__mcp_connector__MCPConnectorTool
                run_python:
                  $ref: >-
                    #/components/schemas/llm_training__agents__tools__schemas__run_python__RunPython
                web_search:
                  $ref: >-
                    #/components/schemas/llm_training__agents__tools__schemas__web_search__WebSearch
          type: array
          title: Tools
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        last_deployed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Deployed At
        active_duration:
          type: integer
          minimum: 0
          title: Active Duration
          default: 0
      type: object
      required:
        - id
        - name
        - instructions
        - status
        - reasoning_effort
        - user_id
        - team_id
        - created_at
        - updated_at
      title: AgentSchema
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AgentStatus:
      type: string
      enum:
        - Inactive
        - Pending
        - Active
        - Updating
        - Failed
      title: AgentStatus
    AgentOutputConfig:
      properties:
        frequency:
          anyOf:
            - $ref: '#/components/schemas/AgentOutputFrequency'
            - type: 'null'
          description: >-
            When the agent produces a written response: `always`, `automatic`
            (the agent decides), or `never`.
        instructions:
          anyOf:
            - type: string
            - type: 'null'
          title: Instructions
          description: >-
            Instructions for generating the agent's final response. When set,
            the top-level `instructions` guide only the agent's reasoning, and
            these guide the response.
        model_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Model Id
          description: >-
            The model used to generate the agent's final response, overriding
            the top-level `model_id`. Can be a base model or fine-tuned model.
        temperature:
          anyOf:
            - type: number
              maximum: 2
              minimum: 0
            - type: 'null'
          title: Temperature
          description: >-
            Controls the predictability of the agent's final response. Accepts a
            value from `0` to `2`. Defaults to `0.6`.
      type: object
      title: AgentOutputConfig
    ReasoningEffort:
      type: string
      enum:
        - low
        - medium
        - high
        - speed_optimized
        - performance_optimized
      title: ReasoningEffort
      description: >-
        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`.
    llm_training__agents__tools__schemas__file_search__FileSearch:
      properties:
        name:
          type: string
          const: file_search
          title: Name
        tool_env:
          $ref: '#/components/schemas/FileSearchEnv'
        id:
          type: string
          title: Id
      type: object
      required:
        - name
        - tool_env
      title: FileSearch
    llm_training__agents__tools__schemas__web_search__WebSearch:
      properties:
        name:
          type: string
          const: web_search
          title: Name
        tool_env:
          $ref: '#/components/schemas/WebSearchEnv'
        id:
          type: string
          title: Id
      type: object
      required:
        - name
        - tool_env
      title: WebSearch
    llm_training__agents__tools__schemas__run_python__RunPython:
      properties:
        name:
          type: string
          const: run_python
          title: Name
          default: run_python
        tool_env:
          $ref: '#/components/schemas/RunPythonEnv'
        id:
          type: string
          title: Id
      type: object
      required:
        - tool_env
      title: RunPython
    llm_training__agents__tools__schemas__agent_as_tool__AgentAsTool:
      properties:
        name:
          type: string
          const: agent_as_tool
          title: Name
          default: agent_as_tool
        tool_env:
          $ref: '#/components/schemas/ToolEnv'
          default: {}
        id:
          type: string
          title: Id
        agent_id:
          type: string
          title: Agent Id
        description:
          type: string
          title: Description
      type: object
      required:
        - agent_id
        - description
      title: AgentAsTool
    llm_training__agents__tools__schemas__mcp_connector__MCPConnectorTool:
      properties:
        name:
          type: string
          const: mcp_connector
          title: Name
        tool_env:
          $ref: '#/components/schemas/MCPConnectorToolEnv'
        id:
          type: string
          title: Id
      type: object
      required:
        - name
        - tool_env
      title: MCPConnectorTool
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    AgentOutputFrequency:
      type: string
      enum:
        - always
        - never
        - automatic
      title: AgentOutputFrequency
    FileSearchEnv:
      properties:
        FILE_SEARCH_INDEX:
          type: string
          minLength: 1
          title: File Search Index
        EMBEDDING_MODEL:
          anyOf:
            - type: string
            - type: 'null'
          title: Embedding Model
        DOCUMENT_TOOL_DESC:
          type: string
          minLength: 1
          title: Document Tool Desc
        TOP_K:
          type: integer
          maximum: 100
          minimum: 1
          title: Top K
          description: Top K must be >= 1 and <= 100
          default: 10
        SCORE_THRESHOLD:
          type: number
          exclusiveMaximum: 1
          minimum: 0
          title: Score Threshold
          description: Score must be ≥ 0.0 and < 1.0
          default: 0
      type: object
      required:
        - FILE_SEARCH_INDEX
        - DOCUMENT_TOOL_DESC
      title: FileSearchEnv
    WebSearchEnv:
      properties:
        WEB_SEARCH_TOOL_DESCRIPTION:
          anyOf:
            - type: string
            - type: 'null'
          title: Web Search Tool Description
      type: object
      title: WebSearchEnv
    RunPythonEnv:
      properties:
        RUN_PYTHON_TOOL_DESC:
          anyOf:
            - type: string
            - type: 'null'
          title: Run Python Tool Desc
        FUNCTION_IDS:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Function Ids
      type: object
      title: RunPythonEnv
    ToolEnv:
      properties: {}
      type: object
      title: ToolEnv
      description: Base class for tool environments.
    MCPConnectorToolEnv:
      properties:
        URL:
          type: string
          minLength: 1
          title: Url
        TRANSPORT:
          type: string
          enum:
            - sse
            - streamable-http
          title: Transport
          default: streamable-http
        AUTHORIZATION_URL:
          anyOf:
            - type: string
            - type: 'null'
          title: Authorization Url
      type: object
      required:
        - URL
      title: MCPConnectorToolEnv
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      description: >-
        Your Seekr API key, sent in the Authorization header with no 'Bearer'
        prefix.
      in: header
      name: Authorization

````