---
title: "Run Workflow"
method: POST
path: "/api/v1/agents/workflow/{workflow_name}"
tags: ["Agent Intelligence"]
---

# Run Workflow

`POST /api/v1/agents/workflow/{workflow_name}`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/agents/workflow/{workflow_name}`
- Auth: none declared

Run a pre-built workflow that chains multiple tools in one request.

Each step's results feed into context for subsequent steps.
Returns combined results from all steps plus total cost.

## Path parameters

- `workflow_name` string, required

## Query parameters

- `x_api_key` string, nullable

## Request body

- WorkflowRequest: Input for workflow execution.
  - `lat` number, required
  - `lon` number, required
  - `params` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)