POST /csv

Ingerir filas de CSV (o filas de hojas de cálculo JSON) como documentos borrador, un documento por fila.

Autenticación: JWT Bearer (WorkOS).

Parámetros de consulta

Cuerpo de la solicitud

Se aceptan dos tipos de contenido, enviados según el encabezado Content-Type.

multipart/form-data — campos:

• schema_name (texto, obligatorio)
• file (bytes CSV sin procesar, obligatorio). La primera fila contiene encabezados; cada celda se convierte en un valor de cadena JSON recortado.

application/json (máx. 10 MiB):

{
  "schema_name": "post",
  "spreadsheet_data": [ { "title": "Row 1" }, { "title": "Row 2" } ]
}

• schema_name (cadena, obligatorio)
• spreadsheet_data (arreglo de objetos, obligatorio)

Respuesta

{ "inserted": 2 }

Devuelve 201 Created. Cada fila se convierte en un documento borrador; el título del documento es el primer valor de cadena de la fila.

Ejemplo — JSON

curl -X POST '{CMS_API_URL}/csv?website_id=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -H 'Content-Type: application/json' \
  -d '{"schema_name":"post","spreadsheet_data":[{"title":"Row 1"}]}'

Ejemplo — CSV multiparte

curl -X POST '{CMS_API_URL}/csv?website_id=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -F 'schema_name=post' \
  -F 'file=@data.csv'

Errores

• 400 — errores de análisis, falta schema_name/file, spreadsheet_data que no es un arreglo, filas que no son objetos o CSV vacío
• 401 — JWT faltante o inválido
• 500 — error al insertar