Verificar una publicación de X
Verifica por su identificador una publicación conocida de la misma cuenta o página autorizada. Consulta en vivo sin guardar historial. No busca publicaciones, no lee métricas y no permite repetir un envío. La lectura de publicaciones personales de LinkedIn requiere un permiso restringido independiente de publicar.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Header Parameters
Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.
^conn_Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/tools/x.publicacion.verificar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "publicacionId": "string" } }'{ "data": { "estado": "publicado", "publicacionId": "string", "url": "http://example.com" }, "meta": { "request_id": "string", "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Publicar en X POST
Publica el contenido aprobado en la única cuenta o página de X de esta conexión. Beta privada: requiere permiso explícito y una Idempotency-Key UUID v4 estable. La persona debe aprobar contenido y destino antes de ejecutar. Un resultado pendiente o desconocido exige revisión, nunca otra clave ni otro envío. No programa, borra ni modifica publicaciones. Formatos: texto (280 caracteres ponderados), 1 a 4 imágenes JPG/PNG/GIF/WEBP de hasta 5 MB con texto alternativo, o un único video MP4 de hasta 100 MiB (subida por partes; X valida su duración al publicar). Requiere permiso de subida de medios. Si el canal no termina de procesar un video dentro del tiempo de la corrida, no se publica nada y se informa no_publicado.
Crear un enlace de conexión o recuperar una solicitud puntual POST
La variante general usa el permiso de conexiones.enlace.crear; collection usa el de sii.carpeta_tributaria.generar y requiere piloto habilitado. En colección, la misma clave y cuerpo recuperan la solicitud del mismo actor y organización. Mientras espera autorización conserva la URL válida; después devuelve collection_status e identificadores sin URL. El HTTP 201 se conserva en ambos casos. status describe la sesión cuando aparece; collection_status describe la solicitud.