API

Here are the different routes provided by the application. You can implement whatever front-end you like on top of it.

The API supports HTTP Basic authentication through the Authorization Header. By default, each authorization is only valid for one request (ie. the sessions are automatically revoked after each request complete). You can ask for reusable sessions though. Here are the HTTP headers supported:

  • X-Reuse-Session: set it to true to be able to reuse sessions
  • X-Language: set it to whatever supported language you want

Don’t forget to call /logout once you’re done if you choose to use reusable sessions.

DELETE /api/preferences/ui/hide

Make a client/server visible again

DELETE method provided by the webservice.

PUT /api/preferences/ui/hide

Hide a client/server

PUT method provided by the webservice.

Returns:Object to hide
GET /api/preferences/ui/hide

Returns a list of hidden clients/servers

GET method provided by the webservice.

Returns:list
GET /api/admin/auth/backends

Returns a list of backends

GET method provided by the webservice.

Returns:Backends
DELETE /api/admin/auth/(backend)/users/(name)
DELETE /api/admin/auth/(backend)/users
DELETE /api/admin/auth/users/(name)
DELETE /api/admin/auth/users

Delete a user

POST /api/admin/auth/(backend)/users/(name)
POST /api/admin/auth/(backend)/users
POST /api/admin/auth/users/(name)
POST /api/admin/auth/users

Change user password

PUT /api/admin/auth/(backend)/users/(name)
PUT /api/admin/auth/(backend)/users
PUT /api/admin/auth/users/(name)
PUT /api/admin/auth/users

Create a new user

GET /api/admin/auth/(backend)/users/(name)
GET /api/admin/auth/(backend)/users
GET /api/admin/auth/users/(name)
GET /api/admin/auth/users

Returns a list of users

GET method provided by the webservice.

Returns:Users
GET /api/admin/acl/(backend)/moderators
GET /api/admin/acl/moderators

Returns a list of moderators

GET method provided by the webservice.

Returns:Moderators
DELETE /api/admin/acl/(backend)/moderator/(member)
DELETE /api/admin/acl/(backend)/moderator
DELETE /api/admin/acl/moderator

Remove a moderator member

DELETE method provided by the webservice.

POST /api/admin/acl/(backend)/moderator/(member)
POST /api/admin/acl/(backend)/moderator
POST /api/admin/acl/moderator

Update moderator grants

POST method provided by the webservice.

PUT /api/admin/acl/(backend)/moderator/(member)
PUT /api/admin/acl/(backend)/moderator
PUT /api/admin/acl/moderator

Add a member as moderator

PUT method provided by the webservice.

GET /api/admin/acl/(backend)/moderator/(member)
GET /api/admin/acl/(backend)/moderator
GET /api/admin/acl/moderator

Returns a list of moderator users

GET method provided by the webservice.

Returns:Members
GET /api/admin/acl/backends

Returns a list of backends

GET method provided by the webservice.

Returns:Backends
GET /api/admin/acl/(backend)/admins
GET /api/admin/acl/admins

Returns a list of admins

GET method provided by the webservice.

Returns:Moderators
DELETE /api/admin/acl/(backend)/groups/(name)
DELETE /api/admin/acl/(backend)/groups
DELETE /api/admin/acl/groups/(name)
DELETE /api/admin/acl/groups

Delete a group

POST /api/admin/acl/(backend)/groups/(name)
POST /api/admin/acl/(backend)/groups
POST /api/admin/acl/groups/(name)
POST /api/admin/acl/groups

Change a group

PUT /api/admin/acl/(backend)/groups/(name)
PUT /api/admin/acl/(backend)/groups
PUT /api/admin/acl/groups/(name)
PUT /api/admin/acl/groups

Create a new group

GET /api/admin/acl/(backend)/groups/(name)
GET /api/admin/acl/(backend)/groups
GET /api/admin/acl/groups/(name)
GET /api/admin/acl/groups

Returns a list of group

GET method provided by the webservice.

Returns:Groups
DELETE /api/admin/acl/(backend)/grants/(name)
DELETE /api/admin/acl/(backend)/grants
DELETE /api/admin/acl/grants/(name)
DELETE /api/admin/acl/grants

Delete a grant

POST /api/admin/acl/(backend)/grants/(name)
POST /api/admin/acl/(backend)/grants
POST /api/admin/acl/grants/(name)
POST /api/admin/acl/grants

Change a grant

PUT /api/admin/acl/(backend)/grants/(name)
PUT /api/admin/acl/(backend)/grants
PUT /api/admin/acl/grants/(name)
PUT /api/admin/acl/grants

Create a new grant

GET /api/admin/acl/(backend)/grants/(name)
GET /api/admin/acl/(backend)/grants
GET /api/admin/acl/grants/(name)
GET /api/admin/acl/grants

Returns a list of grants

GET method provided by the webservice.

Returns:Grants
DELETE /api/admin/acl/(backend)/admin/(member)
DELETE /api/admin/acl/(backend)/admin
DELETE /api/admin/acl/admin

Remove an admin member

DELETE method provided by the webservice.

PUT /api/admin/acl/(backend)/admin/(member)
PUT /api/admin/acl/(backend)/admin
PUT /api/admin/acl/admin

Add a member as admin

PUT method provided by the webservice.

GET /api/admin/acl/(backend)/admin/(member)
GET /api/admin/acl/(backend)/admin
GET /api/admin/acl/admin

Returns a list of admin users

GET method provided by the webservice.

Returns:Members
DELETE /api/admin/acl/(backend)/group/(name)/(member)
DELETE /api/admin/acl/(backend)/group/(name)
DELETE /api/admin/acl/group

Remove a member from a given group

DELETE method provided by the webservice.

PUT /api/admin/acl/(backend)/group/(name)/(member)
PUT /api/admin/acl/(backend)/group/(name)
PUT /api/admin/acl/group

Add a member in a given group

PUT method provided by the webservice.

GET /api/admin/acl/(backend)/group/(name)/(member)
GET /api/admin/acl/(backend)/group/(name)
GET /api/admin/acl/group

Returns a list of users in a giver group

GET method provided by the webservice.

Returns:Members
DELETE /api/admin/me/session/(uuid: id)
DELETE /api/admin/me/session

Delete a given session

Note: id is mandatory

GET /api/admin/me/session/(uuid: id)
GET /api/admin/me/session

Returns a list of sessions

GET method provided by the webservice.

Returns:Sessions
DELETE /api/preferences/ui

Delete prefs

POST /api/preferences/ui

Change prefs

PUT /api/preferences/ui

Create prefs

GET /api/preferences/ui

Returns a list of prefs

GET method provided by the webservice.

Returns:prefs
DELETE /api/settings/(server)/server-config/(path: conf)
DELETE /api/settings/(server)/server-config
DELETE /api/settings/server-config/(path: conf)
DELETE /api/settings/server-config

Deletes a configuration file

POST /api/settings/(server)/server-config/(path: conf)
POST /api/settings/(server)/server-config
POST /api/settings/server-config/(path: conf)
POST /api/settings/server-config

Saves the server configuration

GET /api/settings/(server)/server-config/(path: conf)
GET /api/settings/(server)/server-config
GET /api/settings/server-config/(path: conf)
GET /api/settings/server-config

Reads the server configuration

GET method provided by the webservice.

The JSON returned is:

{
  "boolean": [
    "daemon",
    "fork",
    "..."
  ],
  "defaults": {
    "address": "",
    "autoupgrade_dir": "",
    "ca_burp_ca": "",
    "ca_conf": "",
    "ca_name": "",
    "ca_server_name": "",
    "client_can_delete": true,
    "...": "..."
  },
  "integer": [
    "port",
    "status_port",
    "..."
  ],
  "multi": [
    "keep",
    "restore_client",
    "..."
  ],
  "placeholders": {
    "autoupgrade_dir": "path",
    "ca_burp_ca": "path",
    "ca_conf": "path",
    "ca_name": "name",
    "ca_server_name": "name",
    "client_can_delete": "0|1",
    "...": "..."
  },
  "results": {
    "boolean": [
      {
        "name": "hardlinked_archive",
        "value": false,
        "reset": false
      },
      {
        "name": "syslog",
        "value": true,
        "reset": false
      },
      { "...": "..." }
    ],
    "clients": [
      {
        "name": "testclient",
        "value": "/etc/burp/clientconfdir/testclient"
      }
    ],
    "common": [
      {
        "name": "mode",
        "value": "server",
        "reset": false
      },
      {
        "name": "directory",
        "value": "/var/spool/burp",
        "reset": false
      },
      { "...": "..." }
    ],
    "includes": [],
    "includes_ext": [],
    "integer": [
      {
        "name": "port",
        "value": 4971,
        "reset": false
      },
      {
        "name": "status_port",
        "value": 4972,
        "reset": false
      },
      { "...": "..." }
    ],
    "multi": [
      {
        "name": "keep",
        "value": [
          "7",
          "4"
        ],
        "reset": [
          false,
          true
        ]
      },
      { "...": "..." }
    ],
    "hierarchy": [
      {
        "children": [
          {
            "children": [],
            "dir": "/tmp/burp/conf.d",
            "full": "/tmp/burp/conf.d/empty.conf",
            "name": "empty.conf",
            "parent": "/tmp/burp/burp-server.conf"
          },
          {
            "children": [],
            "dir": "/tmp/burp/conf.d",
            "full": "/tmp/burp/conf.d/ipv4.conf",
            "name": "ipv4.conf",
            "parent": "/tmp/burp/burp-server.conf"
          }
        ],
        "dir": "/tmp/burp",
        "full": "/tmp/burp/burp-server.conf",
        "name": "burp-server.conf",
        "parent": null
      }
    ]
  },
  "server_doc": {
    "address": "Defines the main TCP address...",
    "...": "..."
  },
  "string": [
    "mode",
    "address",
    "..."
  ],
  "suggest": {
    "compression": [
      "gzip1",
      "gzip2",
      "gzip3",
      "gzip4",
      "gzip5",
      "gzip6",
      "gzip7",
      "gzip8",
      "gzip9"
    ],
    "mode": [
      "client",
      "server"
    ],
    "...": [
      "..."
    ]
  }
}
Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above.

GET /api/settings/(server)/path-expander/(client)
GET /api/settings/(server)/path-expander
GET /api/settings/path-expander/(client)
GET /api/settings/path-expander

Expends a given path

For instance if it’s given a glob expression it will returns a list of files matching the expression.

GET /api/settings/(server)/templates
GET /api/settings/templates

Returns a list of clients

PUT /api/settings/(server)/template
PUT /api/settings/template

Creates a new template

GET /api/settings/(server)/clients
GET /api/settings/clients

Returns a list of clients

GET /api/settings/(server)/options
GET /api/settings/options

Returns various setting options

PUT /api/settings/(server)/config
PUT /api/settings/config

Creates a new client

GET /api/clients/(server)/backup-running
GET /api/clients/backup-running

Tells if a backup is running right now

GET method provided by the webservice.

The JSON returned is:

{
    "running": false
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above.

GET /api/clients/(server)/running/(client)
GET /api/clients/(server)/running
GET /api/clients/running/(client)
GET /api/clients/running

Returns a list of clients currently running a backup

GET method provided by the webservice.

The JSON returned is:

[
  'client1',
  'client2'
]

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to see.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • client (str) – Ask a specific client in order to know if it is running a backup
Returns:

The JSON described above.

GET /api/servers/report

Returns a global report about all the servers managed by Burp-UI

GET method provided by the webservice.

The JSON returned is:

{
  "backups": [
    {
      "name": "AGENT1",
      "number": 49
    }
  ],
  "servers": [
    {
      "name": "AGENT1",
      "number": {
        "os": {
          "linux": 4
        },
        "total": 349705,
        "totsize": 119400711726
      }
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients/servers you are authorized to.

Returns:The JSON described above.
GET /api/clients/(server)/report
GET /api/clients/report

Returns a global report about all the clients of a given server

GET method provided by the webservice.

The JSON returned is:

{
  "backups": [
    {
      "name": "client1",
      "number": 15
    },
    {
      "name": "client2",
      "number": 1
    }
  ],
  "clients": [
    {
      "name": "client1",
      "stats": {
        "total": 296377,
        "totsize": 57055793698,
        "os": "unknown"
      }
    },
    {
      "name": "client2",
      "stats": {
        "total": 3117,
        "totsize": 5345361,
        "os": "windows"
      }
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above

GET /api/servers/stats

Returns a list of servers (agents) with basic stats

GET method provided by the webservice.

The JSON returned is:

[
  {
    'alive': true,
    'clients': 2,
    'name': 'burp1'
  },
  {
    'alive': false,
    'clients': 0,
    'name': 'burp2'
  }
]
Returns:The JSON described above.
GET /api/clients/(server)/stats
GET /api/clients/stats

Returns a list of clients with their states

GET method provided by the webservice.

The JSON returned is:

{
  [
    {
      "last": "2015-05-17 11:40:02",
      "name": "client1",
      "state": "idle",
      "phase": "phase1",
      "percent": 12,
      "labels": [
        "toto"
      ]
    },
    {
      "last": "never",
      "name": "client2",
      "state": "idle",
      "phase": "phase2",
      "percent": 42,
      "labels": [
        "titi"
      ]
    }
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above

GET /api/clients/(server)/all
GET /api/clients/all

Returns a list of all clients with their associated Agent if any

GET method provided by the webservice.

The JSON returned is:

[
  {
    "name": "client1",
    "agent": "agent1"
  },
  {
    "name": "client2",
    "agent": "agent1"
  },
  {
    "name": "client3",
    "agent": "agent2"
  }
]

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above

GET /api/client/(server)/running/(name)
GET /api/client/running/(name)
GET /api/client/(server)/running
GET /api/client/running

Returns the running status of a given client

GET method provided by the webservice.

The JSON returned is:

{
  "state": "running",
  "percent": 42,
  "phase": "2",
  "last": "now"
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

The JSON described above.

GET /api/admin/me

Returns the current user informations

GET method provided by the webservice.

Returns:User
GET /api/misc/languages

Returns a list of supported languages

GET method provided by the webservice.

The JSON returned is:

{
  "en": "English",
  "fr": "Français"
}
Returns:The JSON described above.
GET /api/misc/(server)/counters/(client)
GET /api/misc/(server)/counters
GET /api/misc/counters/(client)
GET /api/misc/counters

Returns counters for a given client

GET method provided by the webservice.

Parameters:
  • name – the client name if any. You can also use the GET parameter ‘name’ to achieve the same thing
Returns:

Counters

GET /api/misc/(server)/monitor
GET /api/misc/monitor

Returns a list of clients that are currently running a backup

GET method provided by the webservice.

The JSON returned is:

[
  {
    'client': 'client1',
    'agent': 'burp1',
    'counters': {
        'phase': 2,
        'path': '/etc/some/configuration',
        '...': '...'
    }
  },
  {
    'client': 'client12',
    'agent': 'burp2',
    'counters': {
        'phase': 3,
        'path': '/etc/some/other/configuration',
        '...': '...'
    }
  }
]

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
Returns:

The JSON described above

GET /api/misc/(server)/history/(client)
GET /api/misc/history/(client)
GET /api/misc/(server)/history
GET /api/misc/history

Returns a list of calendars describing the backups that have been completed so far

GET method provided by the webservice.

The JSON returned is:

[
  {
    "color": "#7C6F44",
    "events": [
      {
        "backup": "0000001",
        "end": "2015-01-25 13:32:04+01:00",
        "name": "toto-test",
        "start": "2015-01-25 13:32:00+01:00",
        "title": "Client: toto-test, Backup n°0000001",
        "url": "/client/toto-test"
      }
    ],
    "name": "toto-test",
    "textColor": "white"
  }
]

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • client (str) – Which client to collect data from
Returns:

The JSON described above

POST /api/misc/alert

Propagate a message to the next screen (or whatever reads the session)

GET /api/misc/(server)/about
GET /api/misc/about

Returns various informations about Burp-UI

GET /api/misc/ping

Tells if the API is alive

GET /api/swagger.json

Render the Swagger specifications as JSON

GET /api/doc

Override this method to customize the documentation page

GET /api/admin/auth/backend/(backend)

Returns a given authentication backend

GET method provided by the webservice.

Returns:Backend
GET /api/admin/acl/(backend)/isModerator/(member)
GET /api/admin/acl/isModerator/(member)

Checks if a given member is moderator

GET /api/admin/acl/groupsOf/(member)

Returns a list of group

GET method provided by the webservice.

Returns:Groups
GET /api/admin/acl/(backend)/isAdmin/(member)
GET /api/admin/acl/isAdmin/(member)

Checks if a given member is admin

GET /api/admin/acl/backend/(backend)

Returns a given ACL backend

GET method provided by the webservice.

Returns:Backend
DELETE /api/settings/(server)/config/(client)/(path: conf)
DELETE /api/settings/config/(client)/(path: conf)
DELETE /api/settings/(server)/config/(client)
DELETE /api/settings/config/(client)

Deletes a given client

POST /api/settings/(server)/config/(client)/(path: conf)
POST /api/settings/config/(client)/(path: conf)
POST /api/settings/(server)/config/(client)
POST /api/settings/config/(client)

Saves a given client configuration

GET /api/settings/(server)/config/(client)/(path: conf)
GET /api/settings/config/(client)/(path: conf)
GET /api/settings/(server)/config/(client)
GET /api/settings/config/(client)

Reads a given client configuration

PUT /api/restore/(server)/server-restore/(name)/(int: backup)
PUT /api/restore/server-restore/(name)/(int: backup)

Schedule a server-initiated restoration

PUT method provided by the webservice.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

Status message (success or failure)

DELETE /api/restore/(server)/server-restore/(name)
DELETE /api/restore/server-restore/(name)

Remove the ‘restore’ file if present

DELETE method provided by the webservice.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

Status message (success or failure)

GET /api/restore/(server)/server-restore/(name)
GET /api/restore/server-restore/(name)

Reads the content of the ‘restore’ file if present

GET method provided by the webservice.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

The content of the restore file

POST /api/restore/(server)/archive/(name)/(int: backup)
POST /api/restore/archive/(name)/(int: backup)

Performs an online restoration

POST method provided by the webservice. This method returns a flask.Response object.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

A flask.Response object representing an archive of the restored files

PUT /api/backup/(server)/do-server-backup/(name)
PUT /api/backup/do-server-backup/(name)

Schedule a server-initiated backup

PUT method provided by the webservice.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

Status message (success or failure)

DELETE /api/backup/(server)/server-backup/(name)
DELETE /api/backup/server-backup/(name)

Remove the ‘backup’ file if present

DELETE method provided by the webservice.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

Status message (success or failure)

GET /api/backup/(server)/server-backup/(name)
GET /api/backup/server-backup/(name)

Tells if a ‘backup’ file is present

GET method provided by the webservice.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

True if the file is found

GET /api/client/(server)/browseall/(name)/(int: backup)
GET /api/client/browseall/(name)/(int: backup)

Returns a list of all ‘nodes’ of a given backup

GET method provided by the webservice.

The JSON returned is:

[
  {
    "date": "2015-05-21 14:54:49",
    "gid": "0",
    "inodes": "173",
    "selected": false,
    "expanded": false,
    "children": [],
    "mode": "drwxr-xr-x",
    "name": "/",
    "key": "/",
    "title": "/",
    "fullname": "/",
    "parent": "",
    "size": "12.0KiB",
    "type": "d",
    "uid": "0"
  }
]

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

The JSON described above.

GET /api/client/(server)/browse/(name)/(int: backup)
GET /api/client/browse/(name)/(int: backup)

Returns a list of ‘nodes’ under a given path

GET method provided by the webservice.

The JSON returned is:

[
  {
    "date": "2015-05-21 14:54:49",
    "gid": "0",
    "inodes": "173",
    "selected": false,
    "expanded": false,
    "children": [],
    "mode": "drwxr-xr-x",
    "name": "/",
    "key": "/",
    "title": "/",
    "fullname": "/",
    "parent": "",
    "size": "12.0KiB",
    "type": "d",
    "uid": "0"
  }
]

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

The JSON described above.

DELETE /api/client/(server)/report/(name)/(int: backup)
DELETE /api/client/(server)/report/(name)
DELETE /api/client/report/(name)/(int: backup)
DELETE /api/client/report/(name)

Deletes a given backup from the server

DELETE method provided by the webservice.

The access is filtered by the burpui.misc.acl module so that you can only delete backups you have access to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
GET /api/client/(server)/report/(name)/(int: backup)
GET /api/client/(server)/report/(name)
GET /api/client/report/(name)/(int: backup)
GET /api/client/report/(name)

Returns a global report of a given backup/client

GET method provided by the webservice.

The JSON returned is:

{
  "dir": {
    "changed": 0,
    "deleted": 0,
    "new": 394,
    "scanned": 394,
    "total": 394,
    "unchanged": 0
  },
  "duration": 5,
  "efs": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "encrypted": true,
  "end": 1422189124,
  "files": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "files_enc": {
    "changed": 0,
    "deleted": 0,
    "new": 1421,
    "scanned": 1421,
    "total": 1421,
    "unchanged": 0
  },
  "hardlink": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "meta": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "meta_enc": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "number": 1,
  "received": 1679304,
  "softlink": {
    "changed": 0,
    "deleted": 0,
    "new": 1302,
    "scanned": 1302,
    "total": 1302,
    "unchanged": 0
  },
  "special": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "start": 1422189119,
  "total": {
    "changed": 0,
    "deleted": 0,
    "new": 3117,
    "scanned": 3117,
    "total": 3117,
    "unchanged": 0
  },
  "totsize": 5345361,
  "vssfooter": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "vssfooter_enc": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "vssheader": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "vssheader_enc": {
    "changed": 0,
    "deleted": 0,
    "new": 0,
    "scanned": 0,
    "total": 0,
    "unchanged": 0
  },
  "windows": "false"
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
  • backup (int) – The backup we are working on
Returns:

The JSON described above.

GET /api/client/(server)/labels/(name)
GET /api/client/labels/(name)

Returns the labels of a given client

GET method provided by the webservice.

The JSON returned is:

{
  "labels": [
    "label1",
    "label2"
  ]
}

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

The JSON described above.

GET /api/client/(server)/stats/(name)
GET /api/client/stats/(name)

Returns a list of backups for a given client

GET method provided by the webservice.

The JSON returned is:

[
  {
    "date": "2015-01-25 13:32:00",
    "deletable": true,
    "encrypted": true,
    "received": 123,
    "size": 1234,
    "number": 1
  },
]

The output is filtered by the burpui.misc.acl module so that you only see stats about the clients you are authorized to.

Parameters:
  • server (str) – Which server to collect data from when in multi-agent mode
  • name (str) – The client we are working on
Returns:

The JSON described above.

GET /api/admin/session/(user)/(uuid: id)
GET /api/admin/session/(user)

Returns a list of sessions

GET method provided by the webservice.

Returns:Sessions