POST /csv

Ingerir linhas CSV (ou linhas de planilha JSON) como documentos rascunho, um documento por linha.

Autenticação: Bearer JWT (WorkOS).

Parâmetros de consulta

Corpo da requisição

Dois tipos de conteúdo são aceitos, selecionados pelo cabeçalho Content-Type.

multipart/form-data — campos:

• schema_name (texto, obrigatório)
• file (bytes CSV brutos, obrigatório). A primeira linha contém os cabeçalhos; cada célula se torna um valor de string JSON aparado.

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

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

• schema_name (string, obrigatório)
• spreadsheet_data (array de objetos, obrigatório)

Resposta

{ "inserted": 2 }

Retorna 201 Created. Cada linha se torna um documento rascunho; o título do documento é o primeiro valor de string da linha.

Exemplo — 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":"Linha 1"}]}'

Exemplo — CSV multipart

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

Erros

• 400 — erros de análise, ausência de schema_name/file, spreadsheet_data que não seja um array, linhas que não sejam objetos ou CSV vazio
• 401 — JWT ausente ou inválido
• 500 — falha na inserção