Skip to main content
GET
/
api
/
conversations
Search Conversations
curl --request GET \
  --url https://app.all-hands.dev/api/conversations \
  --header 'X-Session-API-Key: <api-key>'
{
  "results": [
    {
      "conversation_id": "<string>",
      "title": "<string>",
      "last_updated_at": "2023-11-07T05:31:56Z",
      "status": "STOPPED",
      "runtime_status": "STATUS$STOPPED",
      "selected_repository": "<string>",
      "selected_branch": "<string>",
      "git_provider": "github",
      "trigger": "resolver",
      "num_connections": 0,
      "url": "<string>",
      "session_api_key": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "pr_number": [
        123
      ]
    }
  ],
  "next_page_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://allhandsai-chore-rename-allhands-bot-github-pat-to-pat-token.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Session-API-Key
string
header
required

Query Parameters

​
page_id
string | null
​
limit
integer
default:20
​
selected_repository
string | null
​
conversation_trigger
enum<string> | null
Available options:
resolver,
gui,
suggested_task,
openhands_api,
slack,
microagent_management,
jira,
jira_dc,
linear

Response

Successful Response

​
results
ConversationInfo · object[]
​
next_page_id
string | null