antworkDOCS

Consultar una publicación

La llamada de creación devuelve ids; aquí es donde ves qué ha sido de ellos. Consulta en vez de esperar en la petición de creación, que responde mucho antes de que la plataforma conteste.

GEThttps://antwork.io/api/v1/posts/{id}Permisoread

Petición

curl https://antwork.io/api/v1/posts/pQ7x... \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Respuesta

200 OK
{
  "object": "post",
  "id": "pQ7x...",
  "workspaceId": "ws_...",
  "accountId": "acc_linkedin",
  "platform": "linkedin",
  "campaignId": "b3f1...",
  "status": "published",
  "text": "Shipped the API today.",
  "mediaUrls": [],
  "scheduledFor": "2026-10-01T09:00:00.000Z",
  "publishedAt": "2026-10-01T09:00:04.000Z",
  "publishedUrl": "https://www.linkedin.com/feed/update/...",
  "platformPostId": "urn:li:share:...",
  "error": null,
  "createdAt": "2026-09-22T10:00:00.000Z",
  "updatedAt": "2026-10-01T09:00:04.000Z",
  "readiness": null,
  "editUrl": "https://antwork.io/workspace/ws_.../compose?postId=pQ7x...",
  "settingsUrl": "https://antwork.io/workspace/ws_.../compose?postId=pQ7x...&focus=settings"
}

Una vez ha salido, se rellenan publishedUrl y platformPostId. Si ha fallado, error.message dice qué contestó la plataforma y error.advice qué hacer al respecto.

Hasta que se publica, readiness dice qué le falta a la publicación, con la misma forma que lleva un post_result creado: characterCount frente a characterLimit, overLimit, mediaRequired, settingsRequired y publishBlocker, el código con el que se rechazaría una publicación ahora mismo (null si nada la bloquea). Una vez publicada es null.

editUrl abre la publicación en el editor web de Antwork y settingsUrl la abre con los ajustes de su plataforma a la vista. Manda ahí a una persona para corregir lo que tu integración no puede. Quien no tenga la sesión iniciada entra y llega a la misma página.

Una publicación que no existe, es de otra persona o se ha eliminado responde 404 con post_not_found. Necesita el permiso read.

Estados de una publicación

  • draft — guardada, sin programar. No se enviará.
  • scheduled — esperando su hora, o enviándose ahora mismo.
  • published — publicada en la plataforma. publishedUrl y platformPostId están rellenos.
  • failed — no se publicó. error explica por qué.
  • pending_approval — el espacio de trabajo exige aprobación y nadie la ha aprobado todavía. No está en cola; sale cuando una persona la aprueba en Antwork.

¿Algo no cuadra? Dinos cuál.