Sign in

v4

latestOpenAPI 3.1.02026-08-03427198448.4 KB
codex-schema

Preview Upload

Parse an uploaded spreadsheet server-side and return headers, sample rows, and schema signature.

post/api/codex-schema/preview-upload

Query parameters

user_idstring nullable
org_idstring nullable

Request body

storage_namestring required

Storage path of the uploaded file in agent-uploads bucket.

original_filenamestring required

Original filename for type detection.

sheet_namestring nullable

Sheet to preview when workbook has multiple sheets.

Response

Successful Response

file_typestring required
selected_sheetstring nullable
headersstring[] required
sample_rowsobject[] required
total_rowsinteger required
schema_signaturestring required
schema_versioninteger required