Files and Imports

Files are uploaded resources with signed download URLs. Imports are asynchronous operations that may create or update workspace resources.

Use the file endpoint for short-lived downloads; do not persist signed URLs as permanent links. For imports:

1. Create the import with a workspace and connection context.

2. Store the import id.

3. Poll its status.

4. Retry only when the API marks the import retryable.

5. Reconcile created resources after completion.