Create a file upload entry

POST {{baseUrl}}/.api/api.svc/file_upload/create?title=&totalBytes=&parentId=&documentId=

This will create an upload entry in your digital workplace, to which content can be uploaded with the following POST call.

The response returns an ID code which will be used to refer to the entry in subsequent calls.

Request Params

| Key | Datatype | Required | Description | | title | null | | Required String

The title to display in the digital workplace once the file is uploaded.

Example: {{$randomFileName}} | | totalBytes | null | | Required Integer

File size in bytes.

Example: 1024 | | parentId | null | | String (GUID)

The object ID of the parent object. If you are uploading a file into a folder channel, this is the id of the folder.

Example: {{$randomUUID}} | | documentId | null | | String (GUID)

Used only when creating a new version of an existing document. The object ID of the document.

Example: {{$randomUUID}} |

HEADERS

| Key | Datatype | Required | Description |

RESPONSES

status: OK

"\u003cIglooApiResponse xmlns=\"http://schemas.iglooplatform.com/Igloo.Old.Common\" xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\"\u003e\n    \u003cminRequestPeriod\u003e0\u003c/minRequestPeriod\u003e\n    \u003crequestSupportCode\u003e637606847842670068\u003c/requestSupportCode\u003e\n    \u003cdictionary i:nil=\"true\" xmlns:a=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\"/\u003e\n    \u003cresponse i:type=\"Model.FileUpload\"\u003e\n        \u003cid\u003e6708551\u003c/id\u003e\n        \u003chref/\u003e\n        \u003cnavType\u003eNone\u003c/navType\u003e\n        \u003cCanBeWatermarked\u003efalse\u003c/CanBeWatermarked\u003e\n        \u003cCategories/\u003e\n        \u003cChunkSize\u003e5242880\u003c/ChunkSize\u003e\n        \u003cDescription/\u003e\n        \u003cDocumentHref\u003e/folder/wolverinepng\u003c/DocumentHref\u003e\n        \u003cDocumentId\u003eedb19dc7-c4aa-4b9f-897f-56aece7b800f\u003c/DocumentId\u003e\n        \u003cDocumentTitle\u003eVersioning tests\u003c/DocumentTitle\u003e\n        \u003cLastUploadTick\u003e2021-06-30T21:20:00\u003c/LastUploadTick\u003e\n        \u003cNextChunkIndex\u003e0\u003c/NextChunkIndex\u003e\n        \u003cOwnerId\u003e48713608-a446-42d3-9f59-b75d40b1f1c7\u003c/OwnerId\u003e\n        \u003cParentHref/\u003e\n        \u003cParentId/\u003e\n        \u003cParentTitle/\u003e\n        \u003cTitle\u003eimageupload.png\u003c/Title\u003e\n        \u003cTotalBytes\u003e619397\u003c/TotalBytes\u003e\n        \u003cTransferredBytes\u003e0\u003c/TransferredBytes\u003e\n        \u003cValidationChunk\u003e-1\u003c/ValidationChunk\u003e\n        \u003cValidationChunkSize\u003e1048576\u003c/ValidationChunkSize\u003e\n    \u003c/response\u003e\n\u003c/IglooApiResponse\u003e"