feat: migrate api wrapper to rest v2 - #584

This pull request migrates API helpers to REST API v2 while preserving the public interface and retaining GraphQL for profile reads and registry updates.

Changes:

• Adds REST transport and REST-backed resource operations.
• Updates CLI behavior, errors, tests, examples, and documentation.
• Removes obsolete GraphQL query and mutation builders.

Suppressed comments (3)

runpod/api/ctl_commands.py:197

• volume_mount_path is a public option for both GPU and CPU pods, but this branch only runs when gpu_type_id is set. A CPU pod created from a template with a persistent volume therefore cannot override the inherited path (the previous mutation applied the mount path regardless of GPU/CPU), and a template without mounts also raises KeyError when an override is requested. Remove the GPU-only guard and treat missing mounts as an empty mapping.

    elif template_id and gpu_type_id and volume_mount_path is not None:
        template = run_rest_request(
            "GET", f"/v2/templates/{_path_segment(template_id)}"
        )
        persistent = template["mounts"].get("persistent")

runpod/api/ctl_commands.py:230

• gpu_count is part of the public resume_pod contract, but this line discards it and the REST request always performs an unchanged start. Callers that previously requested a different GPU count now silently get different behavior; pass the count using the REST v2-supported action field, or reject/document the unsupported operation instead of ignoring the argument.

def resume_pod(pod_id: str, gpu_count: int) -> dict:
    """Start a stopped pod."""
    _ = gpu_count
    return run_rest_request(

runpod/cli/groups/project/functions.py:64

• get_pod now returns None for a 404, so a pod that disappears or is temporarily not visible during this polling loop makes the next iteration dereference None with .get and fail with AttributeError. Handle the missing pod explicitly before continuing to poll.

    while new_pod.get("status") != "RUNNING" or new_pod.get("runtime") is None:
        new_pod = get_pod(new_pod["id"])

• Files reviewed: 29/29 changed files
• Comments generated: 3
• Review effort level: Lite