Quick Start

Start by getting or regenerating your API Keys

Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

You can get your API Key by signing up to Netiks Cloud. You can also regenerate the API key from your Netiks Cloud Dashboard at any time.

The best way to interact with our API is to call on a request using your API Key.

Make your first request

To make your first request, send an authenticated request to the Developer Upload Single File API

Upload File (Single File Upload or Confirm Upload)

post

https://prod.backend.netikscloud.comhttps://netiks.s3.amazonaws.com

/api/v1/assets/developer-upload-file/

This endpoint supports two upload modes:

Mode 1: Single File Upload

• Use Content-Type: multipart/form-data

• Upload file directly in the request body as form data

• The file will be processed and stored immediately

Mode 2: Confirm Upload

• Use Content-Type: application/json

• Confirm a file that was previously uploaded via presigned URL

• Include is_presigned: true along with storage details in the JSON body

Both modes return the same response format with asset details upon successful upload.

Header parameters

Content-Typestring · enumRequired

Use 'multipart/form-data' for direct upload or 'application/json' for presigned confirmation

Possible values:

x-api-keystringRequiredExample: ne-zwpVh1idj6InYwTWk866n1qrf

Body

multipart/form-dataapplication/json

filestring · binaryRequired

The file to upload directly

Responses

201

File uploaded successfully (either directly or via presigned confirmation)

application/json

403

API Key Missing

application/json

post

/api/v1/assets/developer-upload-file/

HTTPcURLJavaScriptPython

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: */*

multipart/form-dataapplication/json

{
  "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": "2026-03-18T09:46:19.693Z",
    "last_updated": "2026-03-18T09:46:19.693Z"
  }
}

Take a look at how you might call this method using our APIs, or via curl:

curl

curl -X POST https://prod.backend.netikscloud.com/api/v1/assets/developer-upload-file/ \
  -H "x-api-key: ne-zwpVh1idj6InYwTWk866n1qrf" \
  -F "file=@/path/to/your/file.png"

Node

Python