File Upload REST API Guide | Fiddler AI

👨‍💻 API Reference 📣 Release Notes 📺 Request a Demo

Upload file in a single part

Uploads a file in a single part to Fiddler.

post

/v3/files/upload

Authorizations

Body

filestring · binaryrequired

Binary file object

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/v3/files/upload' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=text'

200

400

500

{
  "api_version": "3.0",
  "kind": "NORMAL",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "filename": "text",
    "type": "CSV",
    "status": "INITIATED",
    "created_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "hello@example.com"
    },
    "updated_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "hello@example.com"
    },
    "created_at": "2025-03-10T06:09:41.981Z",
    "updated_at": "2025-03-10T06:09:41.981Z"
  }
}

File uploaded successfully.

Initiate multi-part upload

Initiates a multi-part upload process for a large file to Fiddler.

post

/v3/files/multipart-init

Authorizations

Body

filenamestringrequired

Name of the file uploaded by the user.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/v3/files/multipart-init' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "filename": "text"
  }'

200

400

500

{
  "api_version": "3.0",
  "kind": "NORMAL",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "filename": "text",
    "type": "CSV",
    "status": "INITIATED",
    "created_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "hello@example.com"
    },
    "updated_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "hello@example.com"
    },
    "created_at": "2025-03-10T06:09:41.981Z",
    "updated_at": "2025-03-10T06:09:41.981Z"
  }
}

Multi-part upload request initiated successfully.

Upload file a part of the file

Uploads a part of a large file to Fiddler as part of a multi-part upload process.

post

/v3/files/multipart-upload

Authorizations

Body

filestring · binaryrequired

Binary file object

file_idstring · uuidrequired

Unique file identifier

part_numberinteger · min: 1 · max: 1000required

Part number of the file in multi-part upload process.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/v3/files/multipart-upload' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=text' \
  --form 'file_id=123e4567-e89b-12d3-a456-426614174000' \
  --form 'part_number=1'

200

400

404

500

{
  "api_version": "3.0",
  "kind": "NORMAL",
  "data": {
    "part_id": 1
  }
}

File part uploaded successfully.

Complete multi-part upload

Completes the multi-part upload process for a large file in Fiddler.

post

/v3/files/multipart-complete

Authorizations

Body

file_idstring · uuid

Unique file identifier

partsobject[]

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/v3/files/multipart-complete' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "file_id": "123e4567-e89b-12d3-a456-426614174000",
    "parts": [
      {
        "id": "text",
        "number": 1
      }
    ]
  }'

200

400

404

500

{
  "api_version": "3.0",
  "kind": "NORMAL",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "filename": "text",
    "type": "CSV",
    "status": "INITIATED",
    "created_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "hello@example.com"
    },
    "updated_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "hello@example.com"
    },
    "created_at": "2025-03-10T06:09:41.981Z",
    "updated_at": "2025-03-10T06:09:41.981Z"
  }
}

Multi-part upload request completed successfully.

Upload file in a single part

Initiate multi-part upload

Upload file a part of the file

Complete multi-part upload

Show child attributes