File Upload REST API Guide

Upload file in a single part

post

Uploads a file in a single part to Fiddler.

Authorizations
Body
filestring · binaryRequired

Binary file object

Responses
200
File uploaded successfully.
application/json
Responseall of
post
POST /v3/files/upload HTTP/1.1
Host: 
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": "2025-07-01T23:08:54.138Z",
    "updated_at": "2025-07-01T23:08:54.138Z"
  }
}

Initiate multi-part upload

post

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

Authorizations
Body
filenamestringRequired

Name of the file uploaded by the user.

Responses
200
Multi-part upload request initiated successfully.
application/json
Responseall of
post
POST /v3/files/multipart-init HTTP/1.1
Host: 
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": "2025-07-01T23:08:54.138Z",
    "updated_at": "2025-07-01T23:08:54.138Z"
  }
}

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
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
200
File part uploaded successfully.
application/json
Responseall of
post
POST /v3/files/multipart-upload HTTP/1.1
Host: 
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
Body
file_idstring · uuidOptional

Unique file identifier

Responses
200
Multi-part upload request completed successfully.
application/json
Responseall of
post
POST /v3/files/multipart-complete HTTP/1.1
Host: 
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": "2025-07-01T23:08:54.138Z",
    "updated_at": "2025-07-01T23:08:54.138Z"
  }
}

Last updated

Was this helpful?