Roster
APIs for managing roster file uploads and processing
List roster jobs for the tenant
Returns a page of roster import jobs belonging to the tenant named in the `tenant-id` header.
Submit a roster file for import
Uploads a roster file and opens a new import job for it.
Re-trigger validation or ingestion for a roster job
Queues the validation or ingestion stage again for a roster job that already exists.
Retrieve a roster job with a file download link
Returns a single roster import job, including a time-limited link to the file that was uploaded for it.
List a roster job's upload attempts
Returns one summary per finished upload attempt of a roster job, oldest first, so you can see how a file changed across corrections - how many rows failed on the first attempt versus the last, and which attempt finally imported.
Retrieve the validation schema for a roster job
Returns the JSON Schema document that governs validation of the rows in one roster job.
Retrieve a download link for failed roster records
Returns a time-limited link to a CSV export of the records that failed for one roster job. **This endpoint does not stream a CSV.** It responds with a small JSON object carrying a `fileUrl`; the caller must follow that link to retrieve the file itself.
Approve or reject a roster import
Records a decision on a roster job that has finished validation and, when approved, starts ingesting its rows.
Replace the file on an existing roster job
Swaps in a corrected file for a roster job that already exists and starts its processing over.