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.
| Param | Type | Required | Notes |
|---|---|---|---|
id | uuid | yes | The csv_sources row id. |
{
"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.
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"
}
curl -X PATCH '{CMS_API_URL}/csv?id=<uuid>' \
-H 'Authorization: Bearer <workos-jwt>' \
-H 'Content-Type: application/json' \
-d '{"status":"ready"}'
400 β no updatable fields provided401 β missing sub claim or invalid JWT404 β no matching row for id + your user500 β update failure