Complete a file

Marks an uploaded file ready for attachment. Call this endpoint after the bytes are uploaded to the URL returned by [Create a file](api:POST/v1/files). Collate validates the uploaded object, records its size, and moves the file from `pending_upload` to `ready`. Files that fail validation move to `failed` and cannot be attached. ## Returns Returns the updated file.