---
title: "Start Conversation"
method: POST
path: "/api/conversations/{conversation_id}/start"
---

# Start Conversation

`POST /api/conversations/{conversation_id}/start`

Start an agent loop for a conversation.

This endpoint calls the conversation_manager's maybe_start_agent_loop method
to start a conversation. If the conversation is already running, it will
return the existing agent loop info.

## Path parameters

- `conversation_id` string, required

## Request body

- ProvidersSetModel
  - `providers_set` ProviderType[], nullable

## Response `200`

Successful Response

- ConversationResponse
  - `status` string, required
  - `conversation_id` string, required
  - `message` string, nullable
  - `conversation_status` 'STARTING' | 'RUNNING' | 'STOPPED'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/all-hands/apis/openhands.md) · [All operations](https://skmtc.dev/all-hands/apis/openhands/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/all-hands/openhands/revisions/4daa2bb4dbf1/schema)