Register an org-level template file and get a presigned upload URL

POST

/organization/templates

POST

/organization/templates

$ curl -X POST https://api.cloudraker.com/organization/templates \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "fileName": "employee_onboarding_template.pdf",
>   "mimeType": "application/pdf"
> }'

201Created

1 {
2   "id": "d4f7a9b2-3c1e-4f8a-9b6d-2e7f5a1c9b0d",
3   "uploadUrl": "https://storage.cloudraker.com/upload/d4f7a9b2-3c1e-4f8a-9b6d-2e7f5a1c9b0d?signature=abc123xyz&expires=1716000000",
4   "uploadExpiresAt": "2024-06-15T14:45:00Z",
5   "file": {
6     "id": "f9e8d7c6b5a4",
7     "fileName": "employee_onboarding_template.pdf",
8     "parentType": "organization",
9     "parentId": "org_987654321",
10     "mimeType": "application/pdf",
11     "size": 245760,
12     "status": "waiting",
13     "processingKind": "",
14     "createdAt": "2024-06-15T14:30:00Z",
15     "processingError": "",
16     "artifacts": [],
17     "indexVectors": false,
18     "indexOntology": false,
19     "storedAt": "",
20     "processedAt": "",
21     "urls": {
22       "file": "",
23       "processedJson": "",
24       "processedMd": "",
25       "previewPdf": ""
26     }
27   }
28 }

Reserves a template file metadata record parented to the caller’s organization (not any space) and returns { id, uploadUrl, uploadExpiresAt, file }. uploadUrl is a secure PUT URL valid for 15 minutes (see uploadExpiresAt, ISO 8601). Two-step upload: PUT the raw bytes to uploadUrl with a Content-Type request header EXACTLY equal to the mimeType you sent, then poll getOrgTemplate until status reaches stored. Request body: fileName (required), mimeType (required), size (bytes, optional). parentType/parentId in the body are ignored: the API forces the parent to this organization. No processing is requested (templates are filled, not parsed). Authorization: org admin (denied → 403).

Reserves a template file metadata record parented to the caller’s organization (not any space) and returns { id, uploadUrl, uploadExpiresAt, file }. `uploadUrl` is a secure PUT URL valid for 15 minutes (see `uploadExpiresAt`, ISO 8601). Two-step upload: PUT the raw bytes to `uploadUrl` with a `Content-Type` request header EXACTLY equal to the `mimeType` you sent, then poll `getOrgTemplate` until `status` reaches `stored`. Request body: `fileName` (required), `mimeType` (required), `size` (bytes, optional). `parentType`/`parentId` in the body are ignored: the API forces the parent to this organization. No processing is requested (templates are filled, not parsed). Authorization: org admin (denied → 403).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

Templates are filled, not parsed: no processingKind is sent, so the file settles at stored and is never indexed. parentType / parentId are ignored.

fileNamestringRequired>=1 character

mimeTypestringRequired>=1 character

sizeintegerOptional0-9007199254740991

Response

Template record created, with its presigned upload URL.

idstring

uploadUrlstring

Presigned upload URL, valid 15 minutes. PUT the raw bytes there with a Content-Type header EXACTLY equal to the mimeType sent at create.

uploadExpiresAtdatetime

fileobject