fn_registry/python/functions/infra/hoppscotch_delete_request.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
hoppscotch_delete_request	function	py	infra	1.0.0	impure	def hoppscotch_delete_request(request_id: str, *, access_token: str, backend_url: str = "http://localhost:3170") -> dict	Borra una request REST de una team collection de Hoppscotch self-hosted via la mutation GraphQL deleteRequest. Protegida por GqlAuthGuard: el JWT de sesion (de hoppscotch_login) viaja en la cookie access_token. Confirma que la mutation devolvio true antes de reportar exito.	hoppscotch flow-replay http infra crud				false	error_go_core	requests	name desc request_id ID de la request a borrar. name desc access_token JWT de sesion (de hoppscotch_login). Viaja en la cookie access_token, NO en el header Authorization. name desc backend_url base del backend Hoppscotch sin barra final. El endpoint GraphQL es {backend_url}/graphql. Default http://localhost:3170.	dict. En exito (data.deleteRequest == true): {status: 'ok', deleted: str}. En error (GraphQL errors, deleteRequest != true, respuesta no JSON, o fallo de transporte): {status: 'error', error: str, data: <cuerpo GraphQL si lo hubo>}. Nunca lanza por errores de red esperables.	true	test_golden_delete_true test_error_delete_false	python/functions/infra/hoppscotch_delete_request_test.py	python/functions/infra/hoppscotch_delete_request.py

Ejemplo

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

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

result = hoppscotch_delete_request(
    request_id="cmq8lue8l000x0xlsd62bncpi",
    access_token=token,
)
print(result)  # {"status": "ok", "deleted": "cmq8lue8l000x0xlsd62bncpi"}

Cuando usarla

Cuando quieras eliminar una request que el agente creo (o que ya no hace falta) de una team collection Hoppscotch self-hosted, y que el humano vea la baja en vivo en la GUI por subscriptions. Util para limpiar requests temporales tras un flujo de prueba. Necesitas el request_id (de hoppscotch_list_requests) 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.
• Operacion destructiva. Borra la request de verdad; no es reversible. Confirma el request_id (p.ej. con hoppscotch_list_requests) antes de borrar.
• Solo data.deleteRequest == true es exito. Cualquier otro valor (false, null) o un bloque errors se reporta como status: 'error'.
• 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 (delete confirmo que la request desaparece de la lista posterior).