FileStorage
This service provides functionality to manage assets and generate pdf. You can upload the assets, get the cdn link for the assets, proxy the assets and many more things.
Operations
GET
# Get details of all namespaces
GET
# Get details of a namespace
POST
# This will complete the upload process. After successfully uploading file, you can call this operation to complete the upload process.
POST
# This operation initiates upload and returns storage link which is valid for 30 Minutes. You can use that storage link to make subsequent upload request with file buffer or blob.
GET
# Browse Files
GET
# Browse Files
GET
# Proxy
POST
# Proxy
GET
# Proxy
POST
# Proxy
Parameters
organization_id
string
Required
This is organization id
Response
200
Success
AllNamespaceDetails
items
array of object (NamespaceDetails)
Array of NamespaceDetails
namespace
string
The namespace identifier
valid_content_types
array of string
Nullable
List of valid content types for the namespace
size
object (SizeConstraints)
SizeConstraints
max
integer
Maximum allowed size (in bytes) for files in the namespace
file_acl
string
Access control level for files in the namespace
Examples
Parameters
organization_id:
"t6hcne7r2ewmc888"
Was this section helpful?
GET
Response
Parameters
namespace
string
Required
Segregation of different types of files(products, orders, logistics etc), Required for validating the data of the file being uploaded, decides where exactly the file will be stored inside the storage bucket.
organization_id
string
Required
This is organization id
Response
200
Success
NamespaceDetails
namespace
string
The namespace identifier
valid_content_types
array of string
Nullable
List of valid content types for the namespace
size
object (SizeConstraints)
SizeConstraints
max
integer
Maximum allowed size (in bytes) for files in the namespace
file_acl
string
Access control level for files in the namespace
Examples
Parameters
namespace:
"test"
organization_id:
"t6hcne7r2ewmc888"
Was this section helpful?
GET
Response
POST
This will complete the upload process. After successfully uploading file, you can call this operation to complete the upload process.
Uploads an arbitrarily sized buffer or blob.
It has three Major Steps:
* Start
* Upload
* Complete
### Start
Initiates the assets upload using `startUpload`.
It returns the storage link in response.
### Upload
Use the storage link to upload a file (Buffer or Blob) to the File Storage.
Make a `PUT` request on storage link received from `startUpload` api with file (Buffer or Blob) as a request body.
### Complete
After successfully upload, call `completeUpload` api to complete the upload process.
This operation will return the url for the uploaded file.
Parameters
namespace
string
Required
Segregation of different types of files(products, orders, logistics etc), Required for validating the data of the file being uploaded, decides where exactly the file will be stored inside the storage bucket.
organization_id
string
Required
This is organization id
Request body
file_name
string
Required
file_path
string
Required
content_type
string
Required
method
string
namespace
string
Required
operation
string
Required
size
integer
Required
upload
object (Upload)
Required
Upload
expiry
integer
Required
url
string
Required
tags
array of string
Response
200
400
Success
FileUploadComplete
_id
string
file_name
string
file_path
string
content_type
string
namespace
string
operation
string
size
integer
upload
object (Upload)
Upload
expiry
integer
url
string
cdn
object (CDN)
CDN
url
string
absolute_url
string
relative_url
string
success
boolean
tags
array of string
created_on
string
| date-time
modified_on
string
| date-time
created_by
object (CreatedBy)
CreatedBy
username
string
Examples
Parameters
namespace:
"test"
organization_id:
"t6hcne7r2ewmc888"
body:
body
Was this section helpful?
POST
Response
POST
This operation initiates upload and returns storage link which is valid for 30 Minutes. You can use that storage link to make subsequent upload request with file buffer or blob.
Uploads an arbitrarily sized buffer or blob.
It has three Major Steps:
* Start
* Upload
* Complete
### Start
Initiates the assets upload using `startUpload`.
It returns the storage link in response.
### Upload
Use the storage link to upload a file (Buffer or Blob) to the File Storage.
Make a `PUT` request on storage link received from `startUpload` api with file (Buffer or Blob) as a request body.
### Complete
After successfully upload, call `completeUpload` api to complete the upload process.
This operation will return the url for the uploaded file.
Parameters
namespace
string
Required
Segregation of different types of files(products, orders, logistics etc), Required for validating the data of the file being uploaded, decides where exactly the file will be stored inside the storage bucket.
organization_id
string
Required
This is organization id
Request body
file_name
string
Required
content_type
string
Required
size
integer
Required
tags
array of string
params
object
Response
200
400
Success. Returns a response containing relaving and absolute_url of storage service
FileUpload
file_name
string
file_path
string
content_type
string
method
string
namespace
string
operation
string
size
integer
upload
object (Upload)
Upload
expiry
integer
url
string
tags
array of string
Examples
Parameters
namespace:
"test"
organization_id:
"t6hcne7r2ewmc888"
body:
body
Was this section helpful?
POST
Response
Parameters
namespace
string
Required
Segregation of different types of files(products, orders, logistics etc), Required for validating the data of the file being uploaded, decides where exactly the file will be stored inside the storage bucket.
organization_id
string
Required
This is organization id
application_id
string
Required
This is application id
company_id
integer
Required
This is company id
page
integer
page no
limit
integer
Limit
Response
200
400
Success
Properties
items
array of object
Array of Properties
_id
string
file_name
string
file_path
string
success
boolean
namespace
string
content_type
string
size
number
operation
string
tags
array of string
cdn
object
Properties
url
string
upload
object
Properties
url
string
expiry
number
created_by
object
Properties
username
string
company_id
number
bucket_key
string
created_at
string
updated_at
string
__v
number
page
object
Properties
item_total
integer
| int32
next_id
string
has_previous
boolean
has_next
boolean
current
integer
| int32
type
string
size
integer
| int32
Examples
Parameters
namespace:
"test"
organization_id:
"t6hcne7r2ewmc888"
application_id:
"5eda528b97457fe43a733ace"
company_id:
2
page:
1
limit:
1
Was this section helpful?
GET
Response
Parameters
namespace
string
Required
Segregation of different types of files(products, orders, logistics etc), Required for validating the data of the file being uploaded, decides where exactly the file will be stored inside the storage bucket.
organization_id
string
Required
This is organization id
page
integer
page no
limit
integer
Limit
Response
200
400
Success
Properties
items
array of object
Array of Properties
_id
string
file_name
string
file_path
string
success
boolean
namespace
string
content_type
string
size
number
operation
string
tags
array of string
cdn
object
Properties
url
string
upload
object
Properties
url
string
expiry
number
created_by
object
Properties
username
string
company_id
number
bucket_key
string
created_at
string
updated_at
string
__v
number
page
object
Properties
item_total
integer
| int32
next_id
string
has_previous
boolean
has_next
boolean
current
integer
| int32
type
string
size
integer
| int32
Examples
Parameters
namespace:
"test"
organization_id:
"t6hcne7r2ewmc888"
page:
1
limit:
1
Was this section helpful?
GET
Response
Parameters
organization_id
string
Required
This is organization id
application_id
string
Required
This is application id
company_id
integer
Required
This is company id
url
string
Required
url
Response
200
Success
FetchProxyDetails
data
object
support
object
Examples
Parameters
organization_id:
"t6hcne7r2ewmc888"
application_id:
"5eda528b97457fe43a733ace"
company_id:
2
url:
"https://reqres.in/api/users/2"
Was this section helpful?
GET
Response
Parameters
organization_id
string
Required
This is organization id
application_id
string
Required
This is application id
company_id
integer
Required
This is company id
Request body
id
integer
customer
string
quantity
integer
price
number
data
object (ProxyFileData)
ProxyFileData
email
string
password
string
url
string
Response
200
Success
SaveProxy
id
integer
token
string
Examples
Parameters
organization_id:
"t6hcne7r2ewmc888"
application_id:
"5eda528b97457fe43a733ace"
company_id:
2
body:
body
Was this section helpful?
POST
Response
Parameters
organization_id
string
Required
This is organization id
url
string
Required
url
Response
200
Success
FetchProxyDetails
data
object
support
object
Examples
Parameters
organization_id:
"t6hcne7r2ewmc888"
url:
"https://reqres.in/api/users/2"
Was this section helpful?
GET
Response
Parameters
organization_id
string
Required
This is organization id
Request body
id
integer
customer
string
quantity
integer
price
number
data
object (ProxyFileData)
ProxyFileData
email
string
password
string
url
string
Response
200
Success
SaveProxy
id
integer
token
string
Examples
Parameters
organization_id:
"t6hcne7r2ewmc888"
body:
body
Was this section helpful?
POST
Response