curl --request GET \
  --url https://api.example.com/api/conversations/search \
  --header 'X-Session-API-Key: <api-key>'

import requests

url = "https://api.example.com/api/conversations/search"

headers = {"X-Session-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-Session-API-Key': '<api-key>'}};

fetch('https://api.example.com/api/conversations/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/conversations/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Session-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/conversations/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Session-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/api/conversations/search")
  .header("X-Session-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/conversations/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Session-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "agent": {
        "acp_command": [
          "<string>"
        ],
        "kind": "ACPAgent",
        "acp_args": [
          "<string>"
        ],
        "acp_file_secrets": [
          {
            "env_var": "<string>",
            "filename": "<string>",
            "secret_name": "<string>",
            "subdir": "<string>",
            "env_points_to": "file",
            "warn_if_unset": []
          }
        ],
        "acp_isolate_data_dir": false,
        "acp_model": "<string>",
        "acp_prompt_timeout": 1800,
        "acp_resume_session_id": "<string>",
        "acp_server": "<string>",
        "acp_session_mode": "<string>",
        "acp_startup_timeout": 90,
        "agent_context": {
          "skills": [
            {
              "content": "When you see this message, you should reply like you are a grumpy cat forced to use the internet.",
              "name": "AGENTS.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!'"
        },
        "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/openai/gpt-5.5"
          },
          "max_size": 80
        },
        "critic": {
          "kind": "AgentFinishedCritic"
        },
        "filter_tools_regex": "^(?!repomix)(.*)|^repomix.*pack_codebase.*$",
        "include_default_tools": [
          "<string>"
        ],
        "llm": {
          "is_subscription": true,
          "api_key": "<string>",
          "api_mode": "auto",
          "api_version": "<string>",
          "auth_type": "api_key",
          "aws_access_key_id": "<string>",
          "aws_bedrock_runtime_endpoint": "<string>",
          "aws_profile_name": "<string>",
          "aws_region_name": "<string>",
          "aws_role_name": "<string>",
          "aws_secret_access_key": "<string>",
          "aws_session_name": "<string>",
          "aws_session_token": "<string>",
          "base_url": "<string>",
          "caching_prompt": true,
          "capability_overrides": {},
          "custom_tokenizer": "<string>",
          "disable_stop_word": false,
          "disable_vision": true,
          "drop_params": true,
          "enable_encrypted_reasoning": true,
          "extended_thinking_budget": 200000,
          "extra_headers": {},
          "force_string_serializer": true,
          "inline_image_urls": true,
          "input_cost_per_token": 1,
          "litellm_extra_body": {},
          "log_completions": false,
          "log_completions_folder": "logs/completions",
          "max_input_tokens": 2,
          "max_message_chars": 30000,
          "max_output_tokens": 2,
          "model": "gpt-5.6",
          "model_canonical_name": "<string>",
          "native_tool_calling": true,
          "num_retries": 5,
          "ollama_base_url": "<string>",
          "openrouter_app_name": "OpenHands",
          "openrouter_site_url": "https://docs.all-hands.dev/",
          "output_cost_per_token": 1,
          "prompt_cache_retention": "24h",
          "provider_connection_id": "<string>",
          "reasoning_effort": "high",
          "reasoning_summary": "auto",
          "retry_max_wait": 64,
          "retry_min_wait": 8,
          "retry_multiplier": 8,
          "seed": 123,
          "stream": false,
          "stream_idle_timeout": 300,
          "subscription_vendor": "openai",
          "temperature": 1,
          "timeout": 300,
          "top_k": 1,
          "top_p": 0.5,
          "usage_id": "default"
        },
        "mcp_config": {
          "fetch": {
            "args": [
              "--with",
              "mcp==1.29.0",
              "mcp-server-fetch==2026.7.10"
            ],
            "command": "uvx"
          }
        },
        "security_policy_filename": "security_policy.j2",
        "system_prompt": "<string>",
        "system_prompt_filename": "system_prompt.j2",
        "system_prompt_kwargs": {
          "cli_mode": true
        },
        "tool_concurrency_limit": 1,
        "tools": [
          {
            "name": "TerminalTool",
            "params": {
              "working_dir": "/workspace"
            }
          }
        ]
      },
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workspace": {
        "kind": "LocalWorkspace",
        "working_dir": "<string>"
      },
      "activated_knowledge_skills": [
        "<string>"
      ],
      "agent_state": {},
      "available_models": [
        {
          "model_id": "<string>",
          "description": "<string>",
          "name": "<string>"
        }
      ],
      "blocked_actions": {},
      "blocked_messages": {},
      "client_tools": [
        {
          "description": "<string>",
          "name": "<string>",
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false,
            "title": "<string>"
          },
          "parameters": {}
        }
      ],
      "confirmation_policy": {
        "kind": "NeverConfirm"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "current_model_id": "<string>",
      "execution_status": "idle",
      "forked_from_conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "forked_from_event_id": "<string>",
      "hook_config": {
        "post_tool_use": [
          {
            "hooks": [
              {
                "command": "<string>",
                "async": false,
                "max_iterations": 3,
                "name": "<string>",
                "prompt": "<string>",
                "system_prompt": "<string>",
                "timeout": 60,
                "tools": [
                  "<string>"
                ],
                "type": "command"
              }
            ],
            "matcher": "*"
          }
        ],
        "pre_tool_use": [
          {
            "hooks": [
              {
                "command": "<string>",
                "async": false,
                "max_iterations": 3,
                "name": "<string>",
                "prompt": "<string>",
                "system_prompt": "<string>",
                "timeout": 60,
                "tools": [
                  "<string>"
                ],
                "type": "command"
              }
            ],
            "matcher": "*"
          }
        ],
        "session_end": [
          {
            "hooks": [
              {
                "command": "<string>",
                "async": false,
                "max_iterations": 3,
                "name": "<string>",
                "prompt": "<string>",
                "system_prompt": "<string>",
                "timeout": 60,
                "tools": [
                  "<string>"
                ],
                "type": "command"
              }
            ],
            "matcher": "*"
          }
        ],
        "session_start": [
          {
            "hooks": [
              {
                "command": "<string>",
                "async": false,
                "max_iterations": 3,
                "name": "<string>",
                "prompt": "<string>",
                "system_prompt": "<string>",
                "timeout": 60,
                "tools": [
                  "<string>"
                ],
                "type": "command"
              }
            ],
            "matcher": "*"
          }
        ],
        "stop": [
          {
            "hooks": [
              {
                "command": "<string>",
                "async": false,
                "max_iterations": 3,
                "name": "<string>",
                "prompt": "<string>",
                "system_prompt": "<string>",
                "timeout": 60,
                "tools": [
                  "<string>"
                ],
                "type": "command"
              }
            ],
            "matcher": "*"
          }
        ],
        "user_prompt_submit": [
          {
            "hooks": [
              {
                "command": "<string>",
                "async": false,
                "max_iterations": 3,
                "name": "<string>",
                "prompt": "<string>",
                "system_prompt": "<string>",
                "timeout": 60,
                "tools": [
                  "<string>"
                ],
                "type": "command"
              }
            ],
            "matcher": "*"
          }
        ]
      },
      "invoked_skills": [
        "<string>"
      ],
      "last_user_message_id": "<string>",
      "launched_agent_profile": {
        "agent_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "revision": 1,
        "secret_refs": [
          "<string>"
        ]
      },
      "leaf_event_id": "<string>",
      "max_iterations": 500,
      "metrics": {
        "accumulated_cost": 0,
        "accumulated_token_usage": {
          "cache_read_tokens": 0,
          "cache_write_tokens": 0,
          "completion_tokens": 0,
          "context_window": 0,
          "model": "",
          "per_turn_token": 0,
          "prompt_tokens": 0,
          "reasoning_tokens": 0,
          "response_id": ""
        },
        "max_budget_per_task": 123,
        "model_name": "default"
      },
      "parent_conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "persistence_dir": "workspace/conversations",
      "runtime_info": {
        "can_resume": true,
        "runtime_status": "available",
        "runtime_error": {
          "code": "<string>",
          "message": "<string>"
        }
      },
      "secret_registry": {
        "secret_sources": {}
      },
      "security_analyzer": {
        "kind": "PatternSecurityAnalyzer",
        "high_patterns": [
          [
            "<string>",
            "<string>",
            "<string>"
          ]
        ],
        "injection_high_patterns": [
          [
            "<string>",
            "<string>",
            "<string>"
          ]
        ],
        "injection_medium_patterns": [
          [
            "<string>",
            "<string>",
            "<string>"
          ]
        ],
        "medium_patterns": [
          [
            "<string>",
            "<string>",
            "<string>"
          ]
        ]
      },
      "stats": {},
      "stuck_detection": true,
      "sub_conversation_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "supports_runtime_model_switch": false,
      "tags": {},
      "title": "<string>",
      "tool_module_qualnames": {},
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_page_id": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "ctx": {},
      "input": "<unknown>"
    }
  ]
}