GET content/upload/{uploadId}

Retrieve the current status of an upload session, and some associated information.

Example

GET /api/v1/content/upload/c1a50a88-0441-4c71-b581-0207f4906c49 HTTP/1.1
Accept: application/json
Authorization: Bearer ...
----------------------------------------
HTTP/1.1 200 OK
Content-Type: application/json

{
  "uploadId": "c1a50a88-0441-4c71-b581-0207f4906c49",
  "status": "initiated",
  "op": "create",
  "created": 1574359119,
  "updated": 1574359119,
  "contentId": "fc20ab3a-5dfe-40ac-b75a-b1d087083e15",
  "revisionId": "b07797fc-2f63-4a35-8c3c-319f844681f3",
  "errors": []
}

Security

Authentication is required, and the upload must have been initiated by this user.

URL Parameters

NameDescriptionValue
uploadIdthe ID of the upload session, as a GUID with dashesstring

Query Parameters

NONE

Request Body

NONE

Response

Successful responses are code 200 with the response body below.

Failure cases:

Response Body

NameDescriptionValue
uploadIdthe ID of the upload session, as a GUID with dashesstring
statusthe current status of the upload session
one of:
  • initiated
  • finalized
  • completed
  • failed
  • timed_out
opthe intended operation for this upload
one of:
  • create
  • revise
createdthe date and time this upload session was initated, as a Unix timestampnumber
updatedthe date and time this upload session was last updated, as a Unix timestampnumber
contentIdthe content identifier, as a GUID with dashesstring
revisionIdthe revision identifier, as a GUID with dashesstring
errorsa list of errors encountered during the processing of this upload; this will be an empty array unless there were errors, and there should only be errors if the status is failedarray of string