Publicaciones

Editar una publicación

Mientras ninguna red haya empezado a enviar, reemplaza targets, fija scheduledAt o pasa entre draft y scheduled. Los campos omitidos se conservan.

PATCHhttps://api.sofia-post.com/api/v1/posts/{id}

PATCH/v1/posts/{id}

Clave de API o token de accesoSe guarda solo en esta pestaña y se envía únicamente a api.sofia-post.com.id (path)Cuerpo de la petición

Esta petición actúa sobre tu cuenta real.

curl -X PATCH 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"scheduledAt":"2026-11-02T10:00:00.000Z"}'

Autorizaciones

Authorizationstringobligatorio
Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Parámetros de ruta

idstringobligatorio
Identificador de la publicación.

Cuerpo

application/json

targetsobject[]
Todos los destinos, reescritos (texto, medios, formato, cuenta); ausente: se conservan
Mostrar atributos hijos
- platformstringobligatorio
  Red de destino
  Valores permitidos: instagramfacebookxlinkedintiktok
- textstringobligatorio
  Pie publicado en esta red
- mediaobject[]
  Medios adjuntos
  Mostrar atributos hijos
  - idstring
    Identificador de un medio de la biblioteca del establecimiento (si no, url y type)
  - urlstring
    Dirección pública del medio (https en live); sin identificador
  - typestring
    Tipo del medio dado por dirección
    Valores permitidos: imagevideo
- formatstring
  Formato (post, reel, story, carousel...); por defecto, el que serviría la red
- accountIdstring
  Live: la cuenta conectada que publica, cuando el establecimiento tiene varias en esta red (GET /v1/establishments/:id/accounts)
scheduledAtstring<date-time>
Nueva fecha, en el futuro: la publicación se programa para esa fecha
statusstring
draft: vuelve a borrador (conserva el contenido, pierde la hora); scheduled: programa en scheduledAt, o a la hora que tenía
Valores permitidos: draftscheduled

Respuesta

200application/json

La publicación tras la edición.

idstringobligatorio
Identificador de la publicación
statusstringobligatorio
En todas las redes; partial: publicada en una, fallida en otra
Valores permitidos: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
establishmentIdstringobligatorio
Establecimiento de la publicación
createdAtstring<date-time>obligatorio
Cuándo se creó la publicación
targetsobject[]obligatorio
Una entrada por red y cuenta: dos cuentas en una red, dos entradas
Mostrar atributos hijos
- platformstringobligatorio
  Red del destino
- accountIdstringobligatorio
  La cuenta que publica (GET /v1/establishments/:id/accounts)
- statestringobligatorio
  Estado del destino en su red
  Valores permitidos: draftscheduledpublishingpublishedsent_to_inboxfailed
- publishedAtstring<date-time>
  Cuándo se publicó el destino
- permalinkstring
  Enlace a la publicación en la red
- errorstring
  Por qué la red la rechazó
scheduledAtstring<date-time>
Cuándo está programada la publicación

402

subscription_required.

403

live_mode_required para una aplicación de prueba, o falta el permiso posts:write.

404

post_not_found: fuera del alcance del token.

409

post_not_editable: una red ha enviado la publicación o la está enviando.

422application/json

post_refused: una red, el establecimiento o Publishing rechazaría la publicación editada. duplicate_platform para dos destinos en una misma red.

4XXapplication/json

Cualquier otro error, en el sobre de error.