API de subida de Lumpa Posting

Autenticación

Los dos endpoints usan el mismo middleware. Manda el token como un header Bearer estándar — no existe un query parameter de API key ni una sesión por cookie.

Header del request

Authorization: Bearer <token>
Accept: application/json

El token identifica al workspace directamente — todo lo que se suba con ese token queda atribuido a ese workspace automáticamente. No existe un campo workspace_id en el body, y un token nunca puede escribir en más de un workspace.

Respuestas de error

Subir video

Sube un video ya renderizado. Se guarda en almacenamiento de objetos (nunca toca disco local) y crea un Video con status Rendered — el mismo estado que tendría un video generado de forma nativa en Lumpa Posting, así que pasa por la misma revisión humana antes de publicarse.

Content-Type: multipart/form-data

Parámetros del body

{
  "id": 123,
  "status": "rendered",
  "public_url": "https://.../videos/....mp4",
  "review_url": "https://www.lumpaposting.com/videos/123/review"
}

Reemplazar video

Cambia el archivo de un video que ya existe — por ejemplo, uno que se volvió a renderizar con música de fondo. Solo se reemplaza el archivo: el status, el copy, la fecha programada y las cuentas autorizadas se conservan, así que un video ya programado se publica a su hora con el archivo nuevo. El archivo anterior se borra después de guardar el nuevo.

Content-Type: multipart/form-data

Parámetros del body

Errores específicos

{
  "id": 123,
  "status": "approved",
  "public_url": "https://.../videos/....mp4",
  "previous_url": "https://.../videos/....mp4",
  "review_url": "https://www.lumpaposting.com/videos/123/review"
}

Subir carrusel

Sube un set de imágenes en su orden final. Siempre crea el post como Draft, aunque venga scheduled_at — una persona sigue eligiendo cuentas y confirmando el envío en el compositor antes de que quede programado de verdad.

Content-Type: multipart/form-data

Parámetros del body

{
  "id": 456,
  "status": "draft",
  "media": [
    "https://.../images/...-0-....jpg",
    "https://.../images/...-1-....jpg"
  ],
  "review_url": "https://www.lumpaposting.com/social-posts/456/edit"
}

Errores

Los dos endpoints comparten el mismo formato para fallas de autenticación y validación.

Programación y zonas horarias

Un scheduled_at sin más, como 2026-08-25 14:00, es ambiguo por sí solo — no dice si es hora de Ciudad de México, UTC o cualquier otra. Los dos endpoints lo resuelven igual:

1. Se interpreta en el campo timezone, si mandas uno.
2. Si no, en la zona horaria configurada del workspace.
3. Si tampoco hay, en la zona horaria default de la aplicación.

El valor resuelto se convierte a UTC antes de guardarse — la base de datos siempre está en UTC, la conversión pasa solo en la frontera. Si omites scheduled_at en un video, lo recoge el scheduler de goteo en vez de necesitar una fecha explícita.

Cliente de referencia

El pipeline de video edicion-de-videos ya llama POST /api/videos desde un cliente pequeño en Python — sirve como ejemplo de implementación real más allá de esta referencia.

data = {"topic": topic, "aspect_ratio": aspect_ratio}
files = {"video": (video_path.name, f, "video/mp4")}

requests.post(
    f"https://www.lumpaposting.com/api/videos",
    headers={"Authorization": f"Bearer {token}", "Accept": "application/json"},
    data=data,
    files=files,
)