Files & Artifacts

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

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

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
  }'

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.