---
name: hoppscotch_update_request
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def hoppscotch_update_request(request_id: str, method: str, url: str, *, title: str | None = None, headers: dict | None = None, body: str | None = None, body_type: str | None = None, access_token: str, backend_url: str = \"http://localhost:3170\") -> dict"
description: "Actualiza una request REST existente en Hoppscotch self-hosted via la mutation GraphQL updateRequest. Reconstruye el HoppRESTRequest canonico reusando build_hoppscotch_collection del registry y lo aplica sobre la request identificada por request_id. Protegida por GqlAuthGuard: el JWT de sesion (de hoppscotch_login) viaja en la cookie access_token."
tags: [hoppscotch, flow-replay, http, infra, crud]
uses_functions: [build_hoppscotch_collection_py_infra]
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [json, requests]
params:
  - name: request_id
    desc: "ID de la request existente a actualizar."
  - name: method
    desc: "metodo HTTP de la request (GET, POST, ...). Se normaliza a mayusculas."
  - name: url
    desc: "endpoint completo de la request (con query string si aplica)."
  - name: title
    desc: "nuevo nombre visible de la request. None = derivar de method + path."
  - name: headers
    desc: "dict name->value de cabeceras de la request. None = sin cabeceras."
  - name: body
    desc: "cuerpo de la request como texto YA serializado. None = sin cuerpo."
  - name: body_type
    desc: "tipo de cuerpo: 'json' | 'form' | 'raw' | None."
  - name: access_token
    desc: "JWT de sesion (de hoppscotch_login). Viaja en la cookie access_token, NO en el header Authorization."
  - name: backend_url
    desc: "base del backend Hoppscotch sin barra final. El endpoint GraphQL es {backend_url}/graphql. Default http://localhost:3170."
output: "dict. En exito: {status: 'ok', id: str, title: str}. En error (GraphQL errors, respuesta no JSON, sin id, o fallo de transporte): {status: 'error', error: str, data: <cuerpo GraphQL si lo hubo>}. Nunca lanza por errores de red esperables."
tested: true
tests:
  - "test_golden_actualiza_request_y_devuelve_id"
  - "test_error_graphql_errors"
test_file_path: "python/functions/infra/hoppscotch_update_request_test.py"
file_path: "python/functions/infra/hoppscotch_update_request.py"
---

## Ejemplo

```python
import sys
sys.path.insert(0, "python/functions")
from infra.hoppscotch_login import hoppscotch_login
from infra.hoppscotch_update_request import hoppscotch_update_request

token = hoppscotch_login("admin@example.com")["access_token"]

# Actualizar una request existente: cambiar metodo, url, titulo y body.
result = hoppscotch_update_request(
    request_id="cmq8lue8l000x0xlsd62bncpi",
    method="POST",
    url="https://api.example.com/login",
    title="Login (actualizado)",
    body='{"user":"neo"}',
    body_type="json",
    access_token=token,
)
print(result)  # {"status": "ok", "id": "...", "title": "Login (actualizado)"}
```

## Cuando usarla

Cuando una request ya existe en una team collection y quieres reescribir su
contenido (metodo, url, cabeceras, body o titulo) desde el agente, para que el
humano vea el cambio reflejado en vivo en la GUI por subscriptions. Necesitas el
`request_id` (de `hoppscotch_list_requests` o de un `hoppscotch_create_request`
previo) y un `access_token` fresco de `hoppscotch_login`.

## Gotchas

- **El access_token va como cookie, no como header Authorization.** La mutation
  esta protegida por GqlAuthGuard que lee el JWT de la cookie `access_token`.
- **El token expira (~24h).** Si la llamada devuelve un error de auth, re-loguea
  con `hoppscotch_login`.
- **`request` debe ser un json string de un HoppRESTRequest v:"2".** El campo
  `request` del input es un string; esta funcion lo serializa con `json.dumps`.
- **Reescribe la request entera, no hace patch.** El HoppRESTRequest enviado
  reemplaza el contenido: pasa todos los campos que quieras conservar, no solo los
  que cambian.
- **Secreto — nunca logear el token en crudo.** Trata el JWT como un secreto.

## Capability growth log

v1.0.0 — version inicial. Validado contra el self-host vivo el 10/06/2026
(create -> update -> list confirmo el titulo actualizado).
