PATCH/api/v6/urlshortener/links/{domain}/{code}

Actualizar un enlace corto

Cambia el estado, la expiración o el destino. El código es inmutable.

Alcance

API key con el servicio urlshortener habilitado

Límite de uso

35 solicitudes por segundo

Actualiza el estado active, la fecha expiresAt (envía null para quitarla) o la longUrl de destino, que se revalida. El código o alias es inmutable. Se requiere al menos un campo.

Parámetros de ruta

domain

stringobligatorio

Dominio del enlace.

code

stringobligatorio

Código corto o alias (en minúsculas).

Cuerpo de la petición

application/json

active

booleanopcional

Activa o desactiva el enlace.

expiresAt

stringopcional

Nueva expiración, o null para quitarla.

longUrl

stringopcional

Nueva URL de destino. Se revalida igual que al crear.

{
  "active": false
}

Respuestas

200

Enlace actualizado.

{
  "success": true,
  "data": {
    "id": 1024,
    "code": "a1b2c3d",
    "domain": "go.acme.co",
    "shortUrl": "https://go.acme.co/a1b2c3d",
    "longUrl": "https://example.com/landing?utm_source=sms",
    "alias": false,
    "active": true,
    "expiresAt": null,
    "createdAt": "2026-06-01T15:04:05Z",
    "clicks": 0,
    "uniqueClicks": 0,
    "lastClickAt": null
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-01T15:04:05+00:00",
    "responseTimeMs": 7.2
  }
}

400

No se envió nada para actualizar, o un campo es inválido.

401

Credenciales inválidas o faltantes.

404

No existe un enlace con ese dominio y código.

429

Se excedió el límite de solicitudes.

Errores posibles

Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.

401AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.401AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.403ACCOUNT_READ_ONLYModo solo lectura: solo pasan GET, HEAD y OPTIONS.400NOTHING_TO_UPDATENo se envió ningún campo actualizable.400URL_INVALIDLa URL de destino está mal formada.400URL_SCHEME_NOT_ALLOWEDSolo se admiten destinos http y https.400URL_TOO_LONGLa URL de destino supera el largo máximo.400URL_BLOCKED_HOSTEl host de destino es privado o reservado.400EXPIRES_AT_INVALID`expiresAt` debe ser una fecha ISO futura.404LINK_NOT_FOUNDNo hay un enlace con ese dominio y código.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.

Ver el catálogo completo

Alcance y límites

Parámetros de ruta

Cuerpo de la petición

Respuestas

Errores posibles