Skip to main content
PATCH
Re-parse the session's file with a different header-row count
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

PATCH /source-creator/sessions//header-rows Description: Re-downloads the session’s original file bytes (from the linked FileDetectionSession’s GCS path) and re-parses using a new headerRows value — useful for prelude-shaped files (e.g. merlin_pandora, merlin_spotify) where the real data header sits below a metadata banner. Re-runs source matching and period detection against the new headers and clears any prior AI-suggested / user-confirmed mappings (column identity changed). Only supported for sessions created via the file-detection flow (FileDetectionSessionId set) and only for CSV/TSV — not Excel, and not sessions uploaded directly via /analyze without a linked detection session. Authorization:
  • Requires royaltyAccess subscription feature
Method: PATCH

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string<uuid>
required

Session ID

Body

application/json
headerRows
integer
required
Required range: x >= 1

Response

Header row updated; file re-parsed

status
string
Example:

"success"

message
string
Example:

"Header row updated; file re-parsed"

data
object