PATCH /csv

Update fields of an existing CSV source row owned by the caller.

Update fields of an existing csv_sources row owned by the calling user.

Auth: Bearer JWT (WorkOS). The update is scoped to your user (the sub claim), so you can only modify your own CSV sources.

Query parameters

Param	Type	Required	Notes
`id`	uuid	yes	The `csv_sources` row id.

Request body

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

Field	Type	Required	Notes
`schema_name`	string	no	New schema name.
`spreadsheet_data`	array	no	Replaces `raw_data`; sets `row_count` to the array length.
`status`	string	no	New status.

All three are optional, but at least one must be provided.

Response

The full updated row:

{
  "id": "...",
  "user_id": "...",
  "schema_name": "post",
  "file_name": "data.csv",
  "file_url": null,
  "raw_data": [],
  "row_count": 1,
  "status": "ready",
  "error_msg": null,
  "created_at": "2026-06-23T18:34:16Z",
  "updated_at": "2026-06-23T20:36:55Z"
}

Example

curl -X PATCH '{CMS_API_URL}/csv?id=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -H 'Content-Type: application/json' \
  -d '{"status":"ready"}'

Errors

400 — no updatable fields provided
401 — missing sub claim or invalid JWT
404 — no matching row for id + your user
500 — update failure

Previous‹POST /csv