Upload File to Storage

Request Method

PUT

Request URL

{PRE_SIGNED_URL} received in the response body of previous API.

Request Headers

Parameter	Data Type	Field Validations	Description
Content-Type	String	Valid mime type	Mandatory. This should be the same as “filecontenttype” used in the previous API. For Excel file, use “application/vnd.ms-excel”

Request Path Params

There are no path parameters for this API.

Request Query Params

There are no query parameters for this API.

Request Body

File to be uploaded as binary.

Response Status Codes

HTTP Status Code	Description
200	OK
400	Bad request
401	Unauthorized
403	Forbidden

Response Schema

NA

Sample Request and Response

Request

curl --location --request PUT 'https://storage.clear.in/v1/ap-south-1/ingestionv2-staging//ADVANCE_INGESTION/2024/FEBRUARY/b7f7be5b-3c10-49a1-b7a4-08147d320f8e/OriginalFileName/b7f7be5b-3c10-49a1-b7a4-08147d320f8e__1707198366785.xlsx?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEO7%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCmFwLXNvdXRoLTEiRjBEAiAfqS6poTq3B7CDA8ESXyc7Zzng4k3CTUYW7Kd3E9wBNgIgQxN6isArvwhnj5RVagOuBZb4POgaOxqswisaWvWI1EsqiwUIt%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAGGgwyMTkzNDE5MDc5ODMiDCTYsIL8NE1t1aPKxCrfBK67deZqwYiP1BZjJPv3tKzvcxc5c98TGlsHevKjrtLhG8Icfjz04cUAS4y2MI%2BDkxNN4veysqqMb5DF5XujEAzBBJ5VHZUbcisgZOw47nCcqySE2Tt23ysn6P%2FU52BEhY8JaFefkPDuzmTkJX%2BxfFupxfrAFBvy1XDiO1tP2d27dh8yBL%2F70KNHJz%2FhjqNpjSIqAaezYukDzx8x7UxaXvxvF%2BzgZWPkUtHhXgGAaJHlA15U3mfdvfswasT3O11YsLkER%2FUjdDQlZPrK0QYKPxy9H%2BH%2B%2BkbMvOxCbPvRsZEoqbb8m519ON9GfD9K1Wzs19MA%2FT%2FRKqSII4obX4cYVLkYUA3cngfF5YWfbP8qyV%2BF1bLJbwmHQq3B3dHL5Lo7eRSnX5qlv1Wh3WWOulHHj5kt3Lbvq6VuFI73wrpSeG6RqqTq8ADsDneObVZ9t2w2AILXqNGL7p%2F9675HdJFWj7n3TzNA1dNGI2Xbh%2Fp3scfoHLoKWiI4AWdAVuC6CHpIs%2FnZb9%2BlZ%2B1NDlaSPxAyTWihxG2cqnMhc8BF3xGxQxiPaLg2yLk6mEnOz8F7lI05d6Nn8DRqI%2Frrb2DweQUGtf7sVXEgcwvXX72vLw8iuYhGFh2wxavFR15jUiG1pEp6rQ0fPGLzmYMeEm5Jcv%2F9Pcd%2F727R26Wq0rRUXJksxK8WPqjHHA2dI2A3vCpWhIbJR%2FHp22mIgLge4QgO043E3kYh%2Fu6w1OACZrQFWJqdh%2BYpi8HoiBjG0rso4t4cF74UI0U82yA1n%2FagYmnM7J0PhijuVPk71Tpt7BERWWkvo0wno%2BHrgY6mwG0%2Bd4xECbss9zXYTJ%2FknLzZgOJVy50VOJVYvHgj77IBtxQuuPK05WkmthlhYkUIj%2B%2FiqzgAhp467zKfMJ0DQWnsUg8eFLF48tPHKeLfvffycdyBN%2FKNKhX3MvfUy%2FfC8yL%2BVK14VyGqBOeIPtmq2jd%2B3EZOSF5G4M%2BY8iTsAX0ONDJRU2mlYGDUKpNRqw3FLgkrrhwzvp%2BD7YQ%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240206T054606Z&X-Amz-SignedHeaders=content-type%3Bhost&X-Amz-Expires=35999&X-Amz-Credential=ASIATGEOL5AH64DYV46U%2F20240206%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Signature=d27d32cb23f5e412934da800733e6fb4824af2f2db31594cddc9e81218903d7c' \
--header 'Content-Type: application/vnd.ms-excel' \
--data '@/C:/Users/admin/report.xlsx'

Response (Success)

HTTP Status Code: 200 OK

The response body will be blank but the status code will be 200 for success.

Response (Failure)

HTTP Status Code: 403 Forbidden

In case the PRE_SIGNED_URL gets expired

<?xml version="1.0" encoding="UTF-8"?>
<Error>
    <Code>AccessDenied</Code>
    <Message>Request has expired</Message>
    <X-Amz-Expires>35999</X-Amz-Expires>
    <Expires>2025-05-19T22:43:43Z</Expires>
    <ServerTime>2025-07-04T06:09:25Z</ServerTime>
    <RequestId>X5T0NQAKMQ5GYCDZ</RequestId>
    <HostId>retwk80WA88AvAa/y93iWdLMDreBW6nvSYS4HNnyKGgJkmTv7iCh+pgN/BCJdEl8b0t/FCKsk5saKc5tAp09JfSIJAyxL1+H</HostId>
</Error>

API Validations

Currently there are no known validations.

API Constraints

Once a pre-signed URL is generated, it will be valid for only 10 mins. If upload fails, generate a new pre-signed URL and try again.