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

# Get Auto Hydration Status

> This endpoint retrieves the current auto hydration status for a specified KVM VPS.

The `api_host` parameter, obtained from the **'Create AUTH-session'** response, must be included in the request to route the request correctly.

Provide the `signature`, `kvm_id`, and `valid_until` parameters from the **'Create AUTH-session'** response to authenticate the request.



## OpenAPI

````yaml post /kvm/v2/get/autohydration_status
openapi: 3.0.0
info:
  title: EDIS Global Management API
  description: >
    Use the API to access and manage your VPS services, including power control,
    rDNS, and VNC management.  

    **Authentication:** Enable API access on any KVM VPS you own. Then use the
    provided credentials to authenticate your requests.
  version: 1.0.0
servers:
  - url: https://{api_host}
    description: Dynamic API host returned from the AUTH session endpoint.
    variables:
      api_host:
        default: api_host.edisglobal.com
        description: >-
          Enter the full API host exactly as returned by /kvm/v2/get/auth (for
          example: 12345.edisglobal.com)
security: []
tags:
  - name: Authentication
    description: Create an AUTH Session
  - name: Power Management
    description: KVM Power Management
  - name: Installation
    description: ISO, Turnkey, Reinstall
  - name: Settings
    description: KVM System Settings
  - name: Collect Information
    description: KVM VPS Details.
  - name: VNC Management
    description: KVM VNC Access
  - name: PTR
    description: KVM Reverse DNS
  - name: Traffic Pool
    description: Traffic Pool Management
  - name: Hooks
    description: KVM Webhook Management
paths:
  /kvm/v2/get/autohydration_status:
    post:
      tags:
        - Traffic Pool
      summary: Get Auto Hydration Status
      description: >-
        This endpoint retrieves the current auto hydration status for a
        specified KVM VPS.


        The `api_host` parameter, obtained from the **'Create AUTH-session'**
        response, must be included in the request to route the request
        correctly.


        Provide the `signature`, `kvm_id`, and `valid_until` parameters from the
        **'Create AUTH-session'** response to authenticate the request.
      operationId: getAutoHydrationStatus
      requestBody:
        description: >-
          Parameters required to retrieve the auto hydration status of a KVM
          VPS.
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                signature:
                  type: string
                  description: >-
                    The session signature obtained from the 'Create
                    AUTH-session' call.
                  example: session_signature_12345
                kvm_id:
                  type: string
                  description: The unique identifier of the KVM VPS.
                  example: kvm_xxxxx_yyyyy
                valid_until:
                  type: string
                  description: >-
                    The expiration timestamp for the session, obtained from the
                    'Create AUTH-session' call.
                  example: '1737476000'
      responses:
        '200':
          description: Auto hydration status retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  response_1:
                    type: object
                    properties:
                      status:
                        type: string
                        example: success
                      auto_hydration:
                        type: string
                        example: 'off'
                  or:
                    type: string
                    example: OR
                  response_2:
                    type: object
                    properties:
                      status:
                        type: string
                        example: success
                      auto_hydration:
                        type: string
                        example: '100'
        '400':
          description: Bad Request - Invalid or missing parameters.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid parameters provided
        '401':
          description: Unauthorized - Invalid or expired session.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid session
        '500':
          description: Internal Server Error - An unexpected error occurred.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Internal server error

````