Sita Docs
  1. Overview
  2. System
  3. API
  4. Models & Files

API

Models & Files API

Implemented

A file is a blob. A model version is what is ingested. The API separates upload from ingest so R2, not the API process, holds the binary.

Framework0103

Why this exists

Why this API boundary exists

A file is a blob. A model version is what is ingested. The API separates upload from ingest so R2, not the API process, holds the binary.

Endpoints

POST/files/init-uploadImplemented

Create a file row and a presigned R2 PUT URL.

Auth: clerk

Framework01

services/api/app/routes/files.py

POST/files/complete-uploadImplemented

Verify the object exists, create model/version, enqueue ingest.

Auth: clerk

Framework0103

services/api/app/routes/files.py

POST/files/{file_id}/reingestImplemented

Re-queue structural ingest for an existing blob.

Auth: clerk

Framework03

services/api/app/routes/files.py

GET/filesImplemented

List org files, optionally filtered by project_id.

Auth: clerk

Framework01

services/api/app/routes/files.py

GET/files/{file_id}/statusImplemented

Poll ingest and element-recognition job status.

Auth: clerk

Framework03

services/api/app/routes/files.py

DELETE/files/{file_id}Implemented

Delete a file and cascade related rows.

Auth: clerk

services/api/app/routes/files.py