Enlaces de conexión

Un enlace por plataforma que conecta, o vuelve a conectar, una cuenta a este espacio.

GEThttps://antwork.io/api/v1/workspaces/{id}/connect-urlsPermisoread

Petición

curl https://antwork.io/api/v1/workspaces/ws_.../connect-urls \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Abre el enlace en el navegador de la persona dueña de la cuenta social: inicia sesión en la plataforma ahí, y la cuenta aparece en GET /api/v1/accounts. El mismo enlace vuelve a conectar una cuenta cuyo tokenHealth lo pida. Requiere el permiso read.

Respuesta

200 OK

{
  "object": "connect_urls",
  "workspaceId": "ws_...",
  "urls": {
    "linkedin": "https://antwork.io/connect/linkedin?workspaceId=ws_...&userId=...&mcpToken=...",
    "x": "https://antwork.io/connect/x?workspaceId=ws_...&userId=...&mcpToken=...",
    "...": "one per platform"
  },
  "alreadyConnected": ["linkedin"],
  "notConnected": ["bluesky", "facebook", "instagram", "pinterest", "threads", "tiktok", "x", "youtube"],
  "requirements": { "instagram": "Instagram connects only a Professional account ..." },
  "expiresAt": "2026-10-22T10:15:00.000Z"
}

Los enlaces funcionan hasta expiresAt, 15 minutos después de la llamada. Pídelos cuando alguien vaya a hacer clic, en lugar de guardarlos. requirements dice qué tiene que ser una cuenta para que su conexión funcione, como una cuenta profesional de Instagram.

Desconectar una cuenta no está en la API: puede cambiar lo que se factura a la cuenta, así que se hace en la web.