cURL

curl -X POST "https://apiweb.mile.app/api/v3/tasks/export" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "download": "xlsx",
    "fields": "startTime,endTime,hubId,createdBy,flow,status",
    "status": "DONE",
    "flowId": "63d8c9b0dbd5ef20a627dd86",
    "hubId": "621dd813eb3ebf16b94d6969",
    "page": 1,
    "limit": 100,
    "sortBy": "createdTime",
    "sortOrder": "desc",
    "background": false
  }'

curl -X POST "https://apiweb.mile.app/api/v3/tasks/export" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "download": "xlsx",
    "flowId": "63d8c9b0dbd5ef20a627dd86",
    "background": true,
    "exportConfigId": "634e98498ce07d29474a7e29"
  }'

const axios = require('axios');

const exportTasks = async () => {
  try {
    const response = await axios.post(
      'https://apiweb.mile.app/api/v3/tasks/export',
      {
        download: 'xlsx',
        fields: 'startTime,endTime,hubId,createdBy,flow,status',
        status: 'DONE',
        flowId: '63d8c9b0dbd5ef20a627dd86',
        hubId: '621dd813eb3ebf16b94d6969',
        page: 1,
        limit: 100,
        sortBy: 'createdTime',
        sortOrder: 'desc',
        background: false
      },
      {
        headers: {
          'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
          'Content-Type': 'application/json'
        }
      }
    );
    
    console.log('Export completed:', response.data);
    console.log('Download link:', response.data.data.link);
  } catch (error) {
    console.error('Export failed:', error.response?.data || error.message);
  }
};

exportTasks();

import requests

url = "https://apiweb.mile.app/api/v3/tasks/export"

payload = {
    "download": "xlsx",
    "fields": "startTime,endTime,hubId,createdBy,flow,status",
    "doneBy": "Leandro",
    "assignee": "[email protected]",
    "status": "DONE",
    "flowId": "63d8c9b0dbd5ef20a627dd86",
    "hubId": "621dd813eb3ebf16b94d6969",
    "page": 1,
    "limit": 20,
    "sortBy": "createdTime",
    "sortOrder": "desc",
    "background": False,
    "exportConfigId": "634e98498ce07d29474a7e29"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    download: 'xlsx',
    fields: 'startTime,endTime,hubId,createdBy,flow,status',
    doneBy: 'Leandro',
    assignee: '[email protected]',
    status: 'DONE',
    flowId: '63d8c9b0dbd5ef20a627dd86',
    hubId: '621dd813eb3ebf16b94d6969',
    page: 1,
    limit: 20,
    sortBy: 'createdTime',
    sortOrder: 'desc',
    background: false,
    exportConfigId: '634e98498ce07d29474a7e29'
  })
};

fetch('https://apiweb.mile.app/api/v3/tasks/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiweb.mile.app/api/v3/tasks/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'download' => 'xlsx',
    'fields' => 'startTime,endTime,hubId,createdBy,flow,status',
    'doneBy' => 'Leandro',
    'assignee' => '[email protected]',
    'status' => 'DONE',
    'flowId' => '63d8c9b0dbd5ef20a627dd86',
    'hubId' => '621dd813eb3ebf16b94d6969',
    'page' => 1,
    'limit' => 20,
    'sortBy' => 'createdTime',
    'sortOrder' => 'desc',
    'background' => false,
    'exportConfigId' => '634e98498ce07d29474a7e29'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiweb.mile.app/api/v3/tasks/export"

	payload := strings.NewReader("{\n  \"download\": \"xlsx\",\n  \"fields\": \"startTime,endTime,hubId,createdBy,flow,status\",\n  \"doneBy\": \"Leandro\",\n  \"assignee\": \"[email protected]\",\n  \"status\": \"DONE\",\n  \"flowId\": \"63d8c9b0dbd5ef20a627dd86\",\n  \"hubId\": \"621dd813eb3ebf16b94d6969\",\n  \"page\": 1,\n  \"limit\": 20,\n  \"sortBy\": \"createdTime\",\n  \"sortOrder\": \"desc\",\n  \"background\": false,\n  \"exportConfigId\": \"634e98498ce07d29474a7e29\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiweb.mile.app/api/v3/tasks/export")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"download\": \"xlsx\",\n  \"fields\": \"startTime,endTime,hubId,createdBy,flow,status\",\n  \"doneBy\": \"Leandro\",\n  \"assignee\": \"[email protected]\",\n  \"status\": \"DONE\",\n  \"flowId\": \"63d8c9b0dbd5ef20a627dd86\",\n  \"hubId\": \"621dd813eb3ebf16b94d6969\",\n  \"page\": 1,\n  \"limit\": 20,\n  \"sortBy\": \"createdTime\",\n  \"sortOrder\": \"desc\",\n  \"background\": false,\n  \"exportConfigId\": \"634e98498ce07d29474a7e29\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apiweb.mile.app/api/v3/tasks/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"download\": \"xlsx\",\n  \"fields\": \"startTime,endTime,hubId,createdBy,flow,status\",\n  \"doneBy\": \"Leandro\",\n  \"assignee\": \"[email protected]\",\n  \"status\": \"DONE\",\n  \"flowId\": \"63d8c9b0dbd5ef20a627dd86\",\n  \"hubId\": \"621dd813eb3ebf16b94d6969\",\n  \"page\": 1,\n  \"limit\": 20,\n  \"sortBy\": \"createdTime\",\n  \"sortOrder\": \"desc\",\n  \"background\": false,\n  \"exportConfigId\": \"634e98498ce07d29474a7e29\"\n}"

response = http.request(request)
puts response.read_body

{
  "Direct Export (background=false)": {
    "value": {
      "status": true,
      "message": "Success",
      "total_data_be": 150,
      "last_id": "61e5477611c1b26cef05d37c",
      "last_field": "status",
      "data": {
        "time": 1644595005,
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "reportType": "task",
        "link": "https://staticdev.mile.app/production-mile/20220211/task_61c2fbaaf27b374e8913fe72_1644595005.xlsx",
        "status": "Done"
      }
    }
  },
  "Background Export (background=true)": {
    "value": {
      "status": true,
      "message": "Export queued for background processing. Check status at GET /tasks/export-log",
      "total_data_be": 0,
      "data": {
        "time": 1644595005,
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "reportType": "task",
        "status": "Processing"
      }
    }
  }
}

{
  "status": false,
  "message": "The download field is required."
}

{
  "status": false,
  "message": "Unauthorized"
}

{
  "status": false,
  "message": "You do not have permission to export tasks"
}

{
  "status": false,
  "message": "Internal server error",
  "error": {
    "message": "<string>",
    "file": "<string>",
    "line_of_code": 123
  }
}

Export Task

Export tasks

Export results allow users to acquire task data by applying specific filters. This endpoint supports two processing modes: direct export (returns file immediately) and background export (queued processing with notification via export-log).

Export Limits:

XLSX format: Up to 1,000,000 tasks
JSON format: Up to 1,000,000 tasks (separated per 10,000 tasks and merged into one zip file)

Processing Modes:

Direct Export (background=false): File returned immediately in response. Best for small datasets (< 10,000 records)
Background Export (background=true): Export queued for processing. Monitor status via GET /tasks/export-log. Best for large datasets

Important Notes:

Use exportConfigId to apply predefined export templates with custom fields and flows
Export files are stored on S3 with 30-day retention
Background exports send completion notification to user’s email

POST

tasks

export

cURL

curl -X POST "https://apiweb.mile.app/api/v3/tasks/export" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "download": "xlsx",
    "fields": "startTime,endTime,hubId,createdBy,flow,status",
    "status": "DONE",
    "flowId": "63d8c9b0dbd5ef20a627dd86",
    "hubId": "621dd813eb3ebf16b94d6969",
    "page": 1,
    "limit": 100,
    "sortBy": "createdTime",
    "sortOrder": "desc",
    "background": false
  }'

curl -X POST "https://apiweb.mile.app/api/v3/tasks/export" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "download": "xlsx",
    "flowId": "63d8c9b0dbd5ef20a627dd86",
    "background": true,
    "exportConfigId": "634e98498ce07d29474a7e29"
  }'

const axios = require('axios');

const exportTasks = async () => {
  try {
    const response = await axios.post(
      'https://apiweb.mile.app/api/v3/tasks/export',
      {
        download: 'xlsx',
        fields: 'startTime,endTime,hubId,createdBy,flow,status',
        status: 'DONE',
        flowId: '63d8c9b0dbd5ef20a627dd86',
        hubId: '621dd813eb3ebf16b94d6969',
        page: 1,
        limit: 100,
        sortBy: 'createdTime',
        sortOrder: 'desc',
        background: false
      },
      {
        headers: {
          'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
          'Content-Type': 'application/json'
        }
      }
    );
    
    console.log('Export completed:', response.data);
    console.log('Download link:', response.data.data.link);
  } catch (error) {
    console.error('Export failed:', error.response?.data || error.message);
  }
};

exportTasks();

import requests

url = "https://apiweb.mile.app/api/v3/tasks/export"

payload = {
    "download": "xlsx",
    "fields": "startTime,endTime,hubId,createdBy,flow,status",
    "doneBy": "Leandro",
    "assignee": "[email protected]",
    "status": "DONE",
    "flowId": "63d8c9b0dbd5ef20a627dd86",
    "hubId": "621dd813eb3ebf16b94d6969",
    "page": 1,
    "limit": 20,
    "sortBy": "createdTime",
    "sortOrder": "desc",
    "background": False,
    "exportConfigId": "634e98498ce07d29474a7e29"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    download: 'xlsx',
    fields: 'startTime,endTime,hubId,createdBy,flow,status',
    doneBy: 'Leandro',
    assignee: '[email protected]',
    status: 'DONE',
    flowId: '63d8c9b0dbd5ef20a627dd86',
    hubId: '621dd813eb3ebf16b94d6969',
    page: 1,
    limit: 20,
    sortBy: 'createdTime',
    sortOrder: 'desc',
    background: false,
    exportConfigId: '634e98498ce07d29474a7e29'
  })
};

fetch('https://apiweb.mile.app/api/v3/tasks/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiweb.mile.app/api/v3/tasks/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'download' => 'xlsx',
    'fields' => 'startTime,endTime,hubId,createdBy,flow,status',
    'doneBy' => 'Leandro',
    'assignee' => '[email protected]',
    'status' => 'DONE',
    'flowId' => '63d8c9b0dbd5ef20a627dd86',
    'hubId' => '621dd813eb3ebf16b94d6969',
    'page' => 1,
    'limit' => 20,
    'sortBy' => 'createdTime',
    'sortOrder' => 'desc',
    'background' => false,
    'exportConfigId' => '634e98498ce07d29474a7e29'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiweb.mile.app/api/v3/tasks/export"

	payload := strings.NewReader("{\n  \"download\": \"xlsx\",\n  \"fields\": \"startTime,endTime,hubId,createdBy,flow,status\",\n  \"doneBy\": \"Leandro\",\n  \"assignee\": \"[email protected]\",\n  \"status\": \"DONE\",\n  \"flowId\": \"63d8c9b0dbd5ef20a627dd86\",\n  \"hubId\": \"621dd813eb3ebf16b94d6969\",\n  \"page\": 1,\n  \"limit\": 20,\n  \"sortBy\": \"createdTime\",\n  \"sortOrder\": \"desc\",\n  \"background\": false,\n  \"exportConfigId\": \"634e98498ce07d29474a7e29\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiweb.mile.app/api/v3/tasks/export")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"download\": \"xlsx\",\n  \"fields\": \"startTime,endTime,hubId,createdBy,flow,status\",\n  \"doneBy\": \"Leandro\",\n  \"assignee\": \"[email protected]\",\n  \"status\": \"DONE\",\n  \"flowId\": \"63d8c9b0dbd5ef20a627dd86\",\n  \"hubId\": \"621dd813eb3ebf16b94d6969\",\n  \"page\": 1,\n  \"limit\": 20,\n  \"sortBy\": \"createdTime\",\n  \"sortOrder\": \"desc\",\n  \"background\": false,\n  \"exportConfigId\": \"634e98498ce07d29474a7e29\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apiweb.mile.app/api/v3/tasks/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"download\": \"xlsx\",\n  \"fields\": \"startTime,endTime,hubId,createdBy,flow,status\",\n  \"doneBy\": \"Leandro\",\n  \"assignee\": \"[email protected]\",\n  \"status\": \"DONE\",\n  \"flowId\": \"63d8c9b0dbd5ef20a627dd86\",\n  \"hubId\": \"621dd813eb3ebf16b94d6969\",\n  \"page\": 1,\n  \"limit\": 20,\n  \"sortBy\": \"createdTime\",\n  \"sortOrder\": \"desc\",\n  \"background\": false,\n  \"exportConfigId\": \"634e98498ce07d29474a7e29\"\n}"

response = http.request(request)
puts response.read_body

{
  "Direct Export (background=false)": {
    "value": {
      "status": true,
      "message": "Success",
      "total_data_be": 150,
      "last_id": "61e5477611c1b26cef05d37c",
      "last_field": "status",
      "data": {
        "time": 1644595005,
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "reportType": "task",
        "link": "https://staticdev.mile.app/production-mile/20220211/task_61c2fbaaf27b374e8913fe72_1644595005.xlsx",
        "status": "Done"
      }
    }
  },
  "Background Export (background=true)": {
    "value": {
      "status": true,
      "message": "Export queued for background processing. Check status at GET /tasks/export-log",
      "total_data_be": 0,
      "data": {
        "time": 1644595005,
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "reportType": "task",
        "status": "Processing"
      }
    }
  }
}

{
  "status": false,
  "message": "The download field is required."
}

{
  "status": false,
  "message": "Unauthorized"
}

{
  "status": false,
  "message": "You do not have permission to export tasks"
}

{
  "status": false,
  "message": "Internal server error",
  "error": {
    "message": "<string>",
    "file": "<string>",
    "line_of_code": 123
  }
}

Authorizations

Authorization

string

header

required

Use a valid Bearer token to authenticate.

Body

application/json

Request body containing export parameters. Use filters to narrow down the dataset and fields parameter to select specific columns.

Request body schema for exporting tasks. Use filters to narrow down the dataset and customize the export output.

download

enum<string>

required

File type that user want to download. There are 2 types of download: enum: json,xlsx Example: xlsx

Available options:

json,

xlsx

fields

string

Fields is for selecting the specific fields that you can choose by multiples to show in the response using a string with a comma delimiter. Example: startTime,endTime,hubId,createdBy,flow,status

doneBy

string

Name of user that completing the task. Example: Leandro

assignee

string

User email for a given task. Example: [email protected]

status

enum<string>

Status of task according to task's data condition. There are 3 types of status: enum: UNASSIGNED,ONGOING,DONE Example: UNASSIGNED

Available options:

UNASSIGNED,

ONGOING,

DONE

flowId

string

The identifier for the flow that generated by system. Use GET /flows API to get the list of flow id. Comma (,) delimiter for filter multiple flow. Example: 63d8c9b0dbd5ef20a627dd86,73d8c9b0dbd5ef20a627dd87

hubId

string

The identifier for the hub that generated by system. Use GET /hubs API to get the list of Hub IDs. Example: 621dd813eb3ebf16b94d6969

page

integer<int32>

Pagination of tasks result list. Example: 2. Default: 1

limit

integer<int32>

Limit of tasks result list. Example: 10. Default: 30

sortBy

string

sortBy is used to sort the result-set in ascending or descending order according to selected field. The value of this param is one of available fields on task objects. Example: flow, assignee, status, hubId, etc. Default: createdTime

sortOrder

enum<string>

sortOrder is to decide ascending or descending order Example: asc or desc. Default: desc

Available options:

asc,

desc

background

boolean

If the user sets the background parameter to true, the export process will utilize background processing, and the results will be available at GET /tasks/export-log API. If the user sets the background parameter to false, the export process will run directly, and the results will be immediately available in the response. Example: true. Default: false

exportConfigId

string

Unique identifier for the export config for allow user to export data using their own configuration. Use GET /export-configs endpoint to get the list of Export Config IDs. Example: 634e98498ce07d29474a7e29

Response

Success - Export completed or queued

status

boolean

Status of response.

message

string

Message of API response.

total_data_be

integer

Total number of tasks successfully exported.

last_id

string

ID of the last task that was successfully exported.

last_field

string

Name of the last field that was successfully exported.

data

object

Export file information. Structure varies based on processing mode (direct vs background).

Show child attributes

Getting Started

Tools

Webhook

Task

Routing

Flow

Workflow

Data

Setting

Import/Export

File

Auth

Objects

Export tasks

Authorizations

Body

Response