Uploads

Upload files to netiks cloud, get the files from your account or using APIs in Assets

Upload Single file

Developer Upload Single File

post
Header parameters
Content-TypestringOptionalExample: multipart/form-data
x-api-keystringRequiredExample: ne-zwpVh1idj6InYwTWk866n1qrf
Body
filestring · binaryRequired
Responses
201

Developer Upload Single File

application/json
post
POST /api/v1/assets/developer-upload-file/ HTTP/1.1
Host: prod.backend.netikscloud.com
x-api-key: text
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}
{
  "message": "text",
  "asset": {
    "id": "text",
    "asset_name": "text",
    "storage_url": "text",
    "location": null,
    "location_name": null,
    "format": "text",
    "file_size": 1,
    "dimensions": null,
    "access": "text",
    "created_by": "text",
    "last_updated_by": "text",
    "created_at": "2025-08-24T05:14:26.330Z",
    "last_updated": "2025-08-24T05:14:26.330Z"
  }
}

Bulk Upload

This is a three step process

Generate Presigned URL

For bulk uploads, it's best to do so by client—start by generating a presigned URL.

Developer Generate Presigned URLs

post
Header parameters
Content-TypestringOptionalExample: application/json
x-api-keystringRequiredExample: ne-zwpVh1idj6InYwTWk866n1qrf
Body
Responses
200

Developer Generate Presigned URLs

application/json
post
POST /api/v1/assets/developer-generate-presigned-url/ HTTP/1.1
Host: prod.backend.netikscloud.com
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "files": [
    {
      "name": "test-image.jpg",
      "type": "image/jpeg",
      "size": 32
    }
  ]
}
{
  "presigned_urls": [
    {
      "file_name": "text",
      "presigned_url": "https://example.com",
      "storage_url": "text",
      "s3_path": "text",
      "content_type": "text"
    }
  ]
}

Upload File using Presigned URL

Next, you will upload the actual files by making a PUT request to the generated presigned URL. This URL is a secure, 15 minutes limited link that allows you to send the file directly to the storage server

Upload File to S3 using Presigned URL Copy

put
Query parameters
X-Amz-Algorithm%3DAWS4-HMAC-SHA256%26X-Amz-Credential%3DAKIAZAT6IHLVD3P2SFV5%2F20250527%2Feu-north-1%2Fs3%2Faws4_request%26X-Amz-Date%3D20250527T231203Z%26X-Amz-Expires%3D3600%26X-Amz-SignedHeaders%3Dcontent-type%3Bhost%26X-Amz-Signature%3Daece8fee9c43cbbba048b80787ef5c08917ea67255649b0d61124f65d7c5fb44stringOptional
Header parameters
Content-TypestringOptionalExample: image/jpeg
Body
string · binaryOptional
Responses
200

Upload File to S3 using Presigned URL

put
PUT /shullyd7%40gmail.com_1746587379/6978f84f-abe5-445e-94ca-9785b4996c95.jpg HTTP/1.1
Host: prod.backend.netikscloud.com
Content-Type: image/jpeg
Accept: */*
Content-Length: 28

"(binary JPEG file content)"
200

Upload File to S3 using Presigned URL

No content

Confirm Upload

Lastly, confirm the upload by sending the details obtained from the Generate Presigned URL API. This step ensures that the system registers the uploaded file

Confirm Upload Presigned File

post
Header parameters
Content-TypestringOptionalExample: application/json
x-api-keystringRequiredExample: ne-zwpVh1idj6InYwTWk866n1qrf
Body
is_presignedbooleanRequired
storage_urlstringRequired
file_namestringRequired
s3_pathstringRequired
content_typestringRequired
Responses
201

Confirm Upload Presigned File

application/json
post
POST /api/v1/assets/developer-upload-file HTTP/1.1
Host: prod.backend.netikscloud.com
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 248

{
  "is_presigned": true,
  "storage_url": "shullyd7@gmail.com_1746587379/6978f84f-abe5-445e-94ca-9785b4996c95.jpg",
  "file_name": "test-image.jpg",
  "s3_path": "shullyd7@gmail.com_1746587379/6978f84f-abe5-445e-94ca-9785b4996c95.jpg",
  "content_type": "image/jpeg"
}
{
  "message": "text",
  "asset": {
    "id": "text",
    "asset_name": "text",
    "storage_url": "text",
    "location": null,
    "location_name": null,
    "format": "text",
    "file_size": 1,
    "dimensions": null,
    "access": "text",
    "created_by": "text",
    "last_updated_by": "text",
    "created_at": "2025-08-24T05:14:26.330Z",
    "last_updated": "2025-08-24T05:14:26.330Z"
  }
}

PreviousAPI ReferenceNextAssets

Last updated