File Upload REST API Guide

Upload file in a single part

post

Uploads a file in a single part to Fiddler.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

filestring · binaryRequired

Binary file object

Responses

200

File uploaded successfully.

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v3/files/upload

HTTPcURLJavaScriptPython

POST /v3/files/upload HTTP/1.1
Host: app.fiddler.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

{
  "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": "[email protected]"
    },
    "updated_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "[email protected]"
    },
    "created_at": "2026-03-06T18:42:00.097Z",
    "updated_at": "2026-03-06T18:42:00.097Z"
  }
}

Initiate multi-part upload

post

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

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

filenamestringRequired

Name of the file uploaded by the user.

Responses

200

Multi-part upload request initiated successfully.

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v3/files/multipart-init

HTTPcURLJavaScriptPython

POST /v3/files/multipart-init HTTP/1.1
Host: app.fiddler.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "filename": "text"
}

{
  "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": "[email protected]"
    },
    "updated_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "[email protected]"
    },
    "created_at": "2026-03-06T18:42:00.097Z",
    "updated_at": "2026-03-06T18:42:00.097Z"
  }
}

Upload file a part of the file

post

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

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

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

200

File part uploaded successfully.

application/json

400

Bad Request

application/json

404

Resource not found

application/json

500

Internal Server Error

application/json

post

/v3/files/multipart-upload

HTTPcURLJavaScriptPython

POST /v3/files/multipart-upload HTTP/1.1
Host: app.fiddler.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 82

{
  "file": "binary",
  "file_id": "123e4567-e89b-12d3-a456-426614174000",
  "part_number": 1
}

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

Complete multi-part upload

post

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

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

file_idstring · uuidOptional

Unique file identifier

Responses

200

Multi-part upload request completed successfully.

application/json

400

Bad Request

application/json

404

Resource not found

application/json

500

Internal Server Error

application/json

post

/v3/files/multipart-complete

HTTPcURLJavaScriptPython

POST /v3/files/multipart-complete HTTP/1.1
Host: app.fiddler.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "file_id": "123e4567-e89b-12d3-a456-426614174000",
  "parts": [
    {
      "id": "text",
      "number": 1
    }
  ]
}

{
  "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": "[email protected]"
    },
    "updated_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "full_name": "text",
      "email": "[email protected]"
    },
    "created_at": "2026-03-06T18:42:00.097Z",
    "updated_at": "2026-03-06T18:42:00.097Z"
  }
}