Start Conversation

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.

POST /api/conversations/{conversation_id}/start

Start Conversation

cURL

curl --request POST \
  --url https://app.all-hands.dev/api/conversations/{conversation_id}/start \
  --header 'Content-Type: application/json' \
  --header 'X-Session-API-Key: <api-key>' \
  --data '
{
  "providers_set": [
    "github"
  ]
}
'

200

{
  "status": "<string>",
  "conversation_id": "<string>",
  "message": "<string>",
  "conversation_status": "STARTING"
}

Authorizations

X-Session-API-Key · string · header · required

Path Parameters

conversation_id · string · required

Body

application/json

providers_set · enum<string>[] | null

Available options: github, gitlab, bitbucket, enterprise_sso

Response

200

application/json

Successful Response

status · string · required

conversation_id · string · required

message · string | null

conversation_status · enum<string> | null

Available options: STARTING, RUNNING, STOPPED