Projects

Returns all projects owned by the authenticated user, scoped by RLS to the caller's tenant. The list is unordered; clients should sort by created_at if display order matters.

Creates a new project (container for uploaded drawings) owned by the authenticated user. The project name must be 1-200 characters. Returns the new project row with its UUID; pass this id to POST /v1/projects/{project_id}/documents to begin uploading drawings.

Mints a presigned S3 PUT URL so the client can upload a drawing file directly to S3 without transiting the API. The returned document_id and upload_url are valid for 15 minutes. After the PUT completes, call POST .../documents/{document_id}/complete to register the document row. Returns 404 if the project is not found or the caller does not own it.

Presigned GET URL for a previously stored artifact. 404 when the artifact does not exist (HeadObject), so a caller can probe cheaply and fall back to recomputing.

Mints a presigned S3 PUT URL for a derived artifact (e.g. the viewer projection) stored beside the document. The name should carry the producer's pipeline version (projection.v64.bin) so stale artifacts are never read after an upgrade. 404 when the document is not the caller's.

Verifies that the client's PUT to upload_url succeeded, computes the SHA-256 hash of the uploaded object, enforces the per-user storage quota, and inserts the project_documents row. Idempotent: retrying an already-completed document_id returns the existing row. Returns 409 if the object has not been uploaded yet; 413 if it exceeds the 200 MB limit; 402 if the storage quota or PAYG ceiling is exhausted.