Create Workspace Document - Raydocs

Create a workspace document from a temporary upload key returned by /vapor/signed-storage-url. If a document with identical content already exists in the same workspace, the API reuses it (sha256 dedup).

Authentication & Scope

Requires documents-write.

Request

POST /workspaces/12/documents HTTP/1.1
Host: api.raydocs.com
Authorization: Bearer <token>
Content-Type: application/json

{
  "key": "tmp/721c7d17-f810-41a8-8c1c-a7e8cd2e52d0",
  "filename": "invoice.pdf"
}

Response

201 Created when new, 200 OK when reused.

{
  "document": {
    "id": "880e8400-e29b-41d4-a716-446655440000",
    "workspace_id": 12,
    "filename": "invoice.pdf",
    "sha256": "6de7f6f5894c9f3fd1f6f8a4d1b3115d0d9b4b19d7a8a661f9fe90f9c2d80c3b",
    "status": "uploaded"
  },
  "dedup": {
    "reused": true,
    "matched_by": "sha256"
  },
  "document_ref": {
    "kind": "documentRef",
    "documentId": "880e8400-e29b-41d4-a716-446655440000",
    "workspaceId": 12
  }
}