---
title: "Route an agent workflow request"
method: POST
path: "/agent/route"
---

# Route an agent workflow request

`POST /agent/route`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/agent/route`
- Auth: none required

Deterministically maps a natural-language BAMF request to the recommended workflow, BAMF Stack skill, REST endpoints, MCP tools, scopes, and approval policy. This observational proposal does not execute; server authority resolves identity, workspace, capability health, provider binding, approval, and idempotency under bamf-agent-turn/v2.

## Request body

- AgentRouteRequest
  - `request` string
  - `message` string
  - `intent` string
  - `app_intent` string
  - `workflow_id` string
  - `visual_type` string
  - `post_id` string
  - `current_post_id` string
  - `has_post_id` boolean
  - `wants_to_mutate` boolean
  - `context` unknown

## Response `200`

Non-executing agent workflow route proposal

- AgentRouteDataResponse
  - `schema` 'bamf.operation-result/v1', required
  - `operation_ref` 'bamf.agent.route.propose/v1', required
  - `data` AgentRouteResponse, required
    - `service` string
    - `version` string
    - `request` AgentRouteRequest
      - `request` string
      - `message` string
      - `intent` string
      - `app_intent` string
      - `workflow_id` string
      - `visual_type` string
      - `post_id` string
      - `current_post_id` string
      - `has_post_id` boolean
      - `wants_to_mutate` boolean
      - `context` unknown
    - `recommended` AgentRouteRecommendation
      - `workflow_id` string
      - `bamf_stack_skill` string, nullable
      - `rest` string[]
      - `mcp` string[]
      - `required_scopes` string[]
      - `mutation_policy` string
      - `confidence` 'high' | 'medium' | 'low'
      - `score` number
      - `reasons` string[]
      - `notes` string[]
      - `ordered_steps` AgentRouteStep[]: Ordered proposal steps for compound requests; each step remains non-executing.
        - `step` integer, required
        - `workflow_id` string, required
        - `depends_on` integer[], required
      - `clarification` AgentRouteClarification
        - `required` boolean, required
        - `reason` string
        - `question` string
      - `approval_required_before_writes` boolean
      - `research_recommended` boolean
      - `research_trigger_terms` string[]
      - `mini_interview_recommended` boolean
      - `mini_interview_trigger_terms` string[]
    - `alternatives` AgentRouteRecommendation[]
      - `workflow_id` string
      - `bamf_stack_skill` string, nullable
      - `rest` string[]
      - `mcp` string[]
      - `required_scopes` string[]
      - `mutation_policy` string
      - `confidence` 'high' | 'medium' | 'low'
      - `score` number
      - `reasons` string[]
      - `notes` string[]
      - `ordered_steps` AgentRouteStep[]: Ordered proposal steps for compound requests; each step remains non-executing.
        - `step` integer, required
        - `workflow_id` string, required
        - `depends_on` integer[], required
      - `clarification` AgentRouteClarification
        - `required` boolean, required
        - `reason` string
        - `question` string
      - `approval_required_before_writes` boolean
      - `research_recommended` boolean
      - `research_trigger_terms` string[]
      - `mini_interview_recommended` boolean
      - `mini_interview_trigger_terms` string[]
    - `next_steps` string[]
  - `receipt` AgentProposalReceipt, required
    - `schema` 'bamf.operation-receipt/v1', required
    - `kind` 'proposal', required
    - `operation_ref` 'bamf.agent.route.propose/v1', required
    - `status` 'proposed', required
    - `executed` unknown, required
    - `execution_requires_separate_operation` unknown, required

## Other responses

- `400`: Invalid route proposal request

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/2337a0710c2e?raw)