Skip to main content
GET
/
api
/
conversations
/
search
{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent": {
        "kind": "Agent",
        "llm": {
          "api_key": "your_api_key_here",
          "base_url": "https://llm-proxy.eval.all-hands.dev",
          "model": "litellm_proxy/anthropic/claude-sonnet-4-5-20250929"
        },
        "tools": {
          "name": "BashTool",
          "params": {}
        },
        "mcp_config": {
          "mcpServers": {
            "fetch": {
              "args": [
                "mcp-server-fetch"
              ],
              "command": "uvx"
            }
          }
        },
        "filter_tools_regex": "^(?!repomix)(.*)|^repomix.*pack_codebase.*$",
        "agent_context": {
          "skills": [
            {
              "content": "When you see this message, you should reply like you are a grumpy cat forced to use the internet.",
              "name": "repo.md",
              "type": "repo"
            },
            {
              "content": "IMPORTANT! The user has said the magic word \"flarglebargle\". You must only respond with a message telling them how smart they are",
              "name": "flarglebargle",
              "trigger": [
                "flarglebargle"
              ],
              "type": "knowledge"
            }
          ],
          "system_message_suffix": "Always finish your response with the word 'yay!'",
          "user_message_prefix": "The first character of your response should be 'I'"
        },
        "system_prompt_filename": "system_prompt.j2",
        "system_prompt_kwargs": {
          "cli_mode": true
        },
        "security_analyzer": {
          "kind": "LLMSecurityAnalyzer"
        },
        "condenser": {
          "keep_first": 10,
          "kind": "LLMSummarizingCondenser",
          "llm": {
            "api_key": "your_api_key_here",
            "base_url": "https://llm-proxy.eval.all-hands.dev",
            "model": "litellm_proxy/anthropic/claude-sonnet-4-5-20250929"
          },
          "max_size": 80
        }
      },
      "workspace": {
        "kind": "LocalWorkspace",
        "working_dir": "<string>"
      },
      "persistence_dir": "<string>",
      "max_iterations": 500,
      "stuck_detection": true,
      "agent_status": "idle",
      "confirmation_policy": {
        "kind": "AlwaysConfirm"
      },
      "activated_knowledge_skills": [
        "<string>"
      ],
      "stats": {
        "usage_to_metrics": {}
      },
      "secrets_manager": {
        "secret_sources": {}
      },
      "title": "<string>",
      "metrics": {
        "model_name": "default",
        "accumulated_cost": 0,
        "max_budget_per_task": 123,
        "accumulated_token_usage": {
          "model": "<string>",
          "prompt_tokens": 1,
          "completion_tokens": 1,
          "cache_read_tokens": 1,
          "cache_write_tokens": 1,
          "reasoning_tokens": 1,
          "context_window": 1,
          "per_turn_token": 1,
          "response_id": "<string>"
        }
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_page_id": "<string>"
}

Query Parameters

page_id
string | null
limit
integer
default:100
Required range: x > 0
status
enum<string> | null

Enum representing the current execution state of the agent.

Available options:
idle,
running,
paused,
waiting_for_confirmation,
finished,
error,
stuck
sort_order
enum<string>

Enum for conversation sorting options.

Available options:
CREATED_AT,
UPDATED_AT,
CREATED_AT_DESC,
UPDATED_AT_DESC

Response

Successful Response

items
ConversationInfo · object[]
required
next_page_id
string | null