Actualizar enlace en Dub, con una API
Cambia un enlace corto; solo cambian los campos enviados. Un nuevo domain o key cambia el propio enlace corto, y archived en true oculta el enlace de Listar enlaces.
- Identificador
- dub_update_link
La llamada
POST https://connect.reportei.com/api/tools/dub_update_link/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"linkId": "<linkId>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| linkId | string | Sí | Id of the link, from List links, Get link or Create link. |
| url | string | No | New destination URL. |
| domain | string | No | Domain of the short link, without protocol, from List domains. |
| key | string | No | Slug of the short link, the part after the domain. |
| archived | boolean | No | true archives the link, false restores it. |
| tagIds | array | No | Ids of all the tags of the link, from List tags or Create tag. |
| folderId | string | No | Id of the folder of the link, from List folders. |
| comments | string | No | Internal notes about the link. |
| utm_source | string | No | UTM source added to the destination URL, replacing the one in it. |
| utm_medium | string | No | UTM medium added to the destination URL, replacing the one in it. |
| utm_campaign | string | No | UTM campaign added to the destination URL, replacing the one in it. |
| utm_term | string | No | UTM term added to the destination URL, replacing the one in it. |
| utm_content | string | No | UTM content added to the destination URL, replacing the one in it. |
| trackConversion | boolean | No | true tracks leads and sales of the link. The workspace needs conversion tracking set up. |
| expiresAt | string | No | When the link expires. |
| expiredUrl | string | No | Where the link sends visitors after it expires. |
| proxy | boolean | No | true shows the custom preview of title, description and image when the link is shared. |
| title | string | No | Title of the custom preview. Used when proxy is true. |
| description | string | No | Description of the custom preview. Used when proxy is true. |
| image | string | No | URL of the image of the custom preview. Used when proxy is true. |
Conexiones posibles
Tu cliente conecta su cuenta de Dub una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/dub, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/dub_update_link. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Dub
- Listar enlacesGETLista los enlaces cortos del workspace con destino, etiquetas, carpeta, parámetros UTM y los conteos de clics, leads y ventas. Para la página siguiente, envía el id del último enlace.
- Obtener enlaceGETDevuelve un enlace corto con los conteos de clics, leads y ventas. Envía domain y key juntos, como dub.sh y abc123 para dub.sh/abc123, o envía linkId.
- Crear enlacePOSTAcorta una URL y devuelve el enlace corto en shortLink, con su id. Sin domain usa el dominio principal del workspace, o dub.sh si no hay.
- Obtener analíticasGETDevuelve clics, leads o ventas del workspace, de un dominio, enlace, etiqueta o carpeta, como total, serie temporal o ranking elegido por groupBy.
- Listar eventosGETLista eventos de clic, lead o venta uno por uno, con hora, enlace y detalles del clic y, para leads y ventas, el cliente. Exige el plan Business o superior.
- Listar dominiosGETLista los dominios personalizados del workspace, cuyo slug va en el argumento domain de las tools de enlace. Las páginas empiezan en 1, y una página menor que pageSize es la última.
- Listar etiquetasGETLista las etiquetas del workspace con sus ids y colores. Las páginas empiezan en 1, y una página menor que pageSize es la última.
- Crear etiquetaPOSTCrea una etiqueta para organizar enlaces, como una campaña o un cliente. La respuesta trae el id que va en tagIds.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
