Complete an upload

Completes a multipart upload after all parts have been sent to the storage service. Provide every part number together with the ETag returned by the storage service for that part.

The storage service verifies the integrity of the assembled content. On success, the session moves to completed and the response includes the resulting file.

The file must be used by a resource within 24 hours (for example as a lesson attachment, an image, an import source or a link in lesson, FAQ, legal term or question reply content). Otherwise it is deleted; file.expires_at shows the deadline.

If the content does not match the declared size, checksum, or content type, the API returns upload_integrity_mismatch with the exact cause in details[].reason. The session is then permanently marked as failed, and a new upload session is required.

The actual size of the assembled file is checked again against the limit of the session purpose. A file above the limit is removed, the session is marked as failed with failure_reason set to too_large, and the API returns 422 validation_failed on size_bytes. A session whose filename extension is outside the list of its purpose fails the same way, with extension_not_allowed and 422 validation_failed on filename.

The actual size is also checked against the storage quota of the account. A file that would take the storage in use above the quota is removed, the session is marked as failed with failure_reason set to storage_quota, and the API returns 409 quota_exceeded with reason, used_bytes, and quota_bytes in details[0].

Path Parameters

Header Parameters

Response Body

curl -X POST "https://example.com/uploads/string/completions" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "parts": [      {        "etag": "string",        "part_number": 0      }    ]  }'

{  "data": {    "expires_at": "2019-08-24T14:15:22Z",    "failure_reason": "string",    "file": {      "checksum": {        "md5": "string",        "sha256": "string"      },      "content_type": "string",      "created_at": "2019-08-24T14:15:22Z",      "expires_at": "2019-08-24T14:15:22Z",      "extension": "string",      "filename": "string",      "id": "string",      "object": "file",      "purpose": "string",      "size_bytes": 0,      "status": "ready"    },    "filename": "string",    "id": "string",    "object": "upload",    "part_size": 0,    "parts_total": 0,    "purpose": "string",    "size_bytes": 0,    "status": "open"  }}