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}

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"}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

Editar una publicación

curl --request PATCH \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduledAt": "2026-11-02T10:00:00.000Z"
}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

PATCH /v1/posts/{id} reescribe los destinos, mueve scheduledAt o cambia status: draft quita el horario y conserva el contenido, scheduled la reprograma. Una vez que una red ha enviado la publicación, la respuesta es 409 post_not_editable.

curl -X PATCH https://api.sofia-post.com/api/v1/posts/$POST_ID \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"status":"scheduled","scheduledAt":"2026-11-20T09:00:00Z"}'

Autorizaciones

Authorizationstringheaderobligatorio
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

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

¿Te ha resultado útil esta página?