Toshl Developer

Update report

Update a report.

PUT /reports/{id}

Required scope:

Parameters

id *
required
string

Report id.

emails
optional
array

An array of emails to send the export file. If not set users default email is used.

export
optional
object

Export details. Sent only if export files should be attached to report emails

resources
optional
array

An array of resources to export.

Possible values: expenses, incomes, budgets, summary, attachments, attachments_grid, balances
formats
optional
array

An array of export formats.

Possible values: csv, xls, pdf, ofx
filters
optional
object

Export filter settings (accounts, categories, tags …)

accounts
optional
array

An array of accounts to export. Default is to export all accounts.

!accounts
optional
array

An array of accounts to not export. Default is to export all accounts.

expenses
optional
object

Expense export filter settings for categories and tags.

incomes
optional
object

Income export filter settings for categories and tags.

locations
optional
array

An array of locations to export. Default is to export all locations.

!locations
optional
array

An array of locations to exclude.

include
optional
object

Which parts of reports should be included.

account_balances
optional
boolean

Include account balances in report.

networth
optional
boolean

Include networth in report.

frequencies
optional
array

List of enabled report frequencies.

Possible values: weekly, monthly, yearly
status
optional
string

Report status.

Possible values: active, inactive

* denotes required field/parameter.

Request

$ curl https://api.toshl.com/reports/42 \
  -H "Authorization: Bearer T9cE5asGnuyYCCqIZFoWjFHvNbvVqHjl" \
  -H "Content-Type: application/json" \
  -X PUT \
  -d '{json}'

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "42",
  "emails": [
    "demo@toshl.com",
    "john@cleese.com"
  ],
  "export": {
    "resources": [
      "expenses",
      "incomes"
    ],
    "formats": [
      "pdf",
      "ofx"
    ],
    "filters": {
      "accounts": ["1","2","3"],
      "expenses": {
        "categories": ["42"],
        "tags": ["44"]
      },
      "incomes": {
        "!categories": ["43"],
        "!tags": ["45"]
      },
      "!locations": ["123"]
    }
  },
  "include": {
    "account_balances": true,
    "networth": true
  },
  "frequencies": [
    "weekly",
    "monthly",
    "yearly"
  ],
  "modified": "2020-10-14T13:55:15Z",
  "status": "active"
}