> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.agentspro.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Session Node

> Get the node assigned to a session

Queries the node bound to a session. If the session has no binding but the user has multiple online nodes, the response returns `requires_selection: true` along with a list of candidate nodes, prompting the frontend to let the user choose.

<ParamField path="session_id" type="string" required>
  Session ID
</ParamField>

<ParamField query="user_id" type="string" required>
  User ID
</ParamField>

<ParamField query="node_type" type="string">
  Filter by node type: `extension` | `desktop`
</ParamField>

<ResponseField name="session_id" type="string">Session ID</ResponseField>
<ResponseField name="node_id" type="string">Bound node ID (may be null)</ResponseField>
<ResponseField name="node" type="object">Node details (returned when bound)</ResponseField>
<ResponseField name="requires_selection" type="boolean">Whether the user needs to manually select a node</ResponseField>
<ResponseField name="available_nodes" type="array">List of candidate nodes (returned when selection is required)</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://zeus-api.agentspro.cn/node/session/sess_456?user_id=user_123'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 (bound) theme={null}
  {
    "session_id": "sess_456",
    "node_id": "node_abc",
    "node": {
      "node_id": "node_abc",
      "node_type": "extension",
      "node_name": "Chrome Extension",
      "status": "online",
      "is_connected": true
    },
    "requires_selection": false,
    "available_nodes": []
  }
  ```

  ```json 200 (selection required) theme={null}
  {
    "session_id": "sess_456",
    "node_id": null,
    "node": null,
    "requires_selection": true,
    "available_nodes": [
      { "node_id": "node_1", "node_name": "Chrome - Work", "is_connected": true },
      { "node_id": "node_2", "node_name": "Chrome - Personal", "is_connected": true }
    ]
  }
  ```
</ResponseExample>