---
title: "Execute an Agent Spec flow"
description: "Submit an Agent Spec flow for execution on the configured runtime\n(WayFlow, PyAgentSpec, or other compatible runtimes).\n\nThe flow is posted as Agent Spec JSON. The runtime returns an\nexecution ID for tracking progress via polling or WebSocket.\n"
source: https://flowdrop.io/docs/api/agent-spec/agentSpecExecuteFlow
site: FlowDrop documentation
---
# Execute an Agent Spec flow
`POST /agentspec/flows/execute`

Submit an Agent Spec flow for execution on the configured runtime
(WayFlow, PyAgentSpec, or other compatible runtimes).

The flow is posted as Agent Spec JSON. The runtime returns an
execution ID for tracking progress via polling or WebSocket.

## Request body

- `application/json` — AgentSpecExecutionRequest

## Responses

- `200` — Flow execution started successfully (`application/json`: AgentSpecExecutionResponse)
- `400` — Bad request - invalid parameters or request body (`application/json`: ErrorResponse)
- `401` — Unauthorized - authentication required (`application/json`: ErrorResponse)
- `500` — Internal server error (`application/json`: ErrorResponse)

*Tags: Agent Spec*