# Files & Artifacts

Use SeaDB for documents, artifacts, delegated uploads, previews, and generated media references.

## Documents

SeaDB document paths are reachable through `/api/seadb/{path}`. Discovery routes include `/_ls/{namespace}` and `/_search?q={query}` through the `/api/seadb` gateway prefix.


## Delegated upload

Large file bytes are uploaded through delegated URLs. First create a delegation, upload to the returned object URL, then complete the delegation.

```bash
curl https://seachat.ai/api/files/delegations/upload \
  -H "Authorization: Bearer $SEACHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "integrations/demo.png",
    "title": "Demo image",
    "mimeType": "image/png",
    "sizeBytes": 12345
  }'
```

## Public previews

Explicit public artifact previews and document share URLs are anonymous read surfaces. The gateway still routes them through SeaGate so audit and storage boundaries stay consistent.