# Save accounting settings

Replace this workspace's accounting settings. Read them first and send the whole object back with your changes; a field left out keeps its stored value. Currency is three capital letters; the fiscal year starts in month 1-12; wait and due-soon days are 0-365; deal SLA and clawback window days are 1-365. `terms` maps vocabulary to key to {label, description, fix}: only known vocabularies and keys are accepted, a label is 1-60 characters, and any key not named keeps its default wording. New deals that omit currency, SLA or clawback window take these defaults.

Access class: `workspace`.

## Endpoint

`PUT /v1/accounting/settings`

## Request body

Content type: `application/json`.

```json
{
  "currency": "string",
  "deal_clawback_window_days": 1,
  "deal_sla_days": 1,
  "exception_soon_days": 1,
  "fiscal_year_start_month": 1,
  "payout_wait_days": 1,
  "terms": {}
}
```

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "settings": {
      "currency": "string",
      "deal_clawback_window_days": 1.5,
      "deal_sla_days": 1.5,
      "exception_soon_days": 1.5,
      "fiscal_year_start_month": 1.5,
      "payout_wait_days": 1.5,
      "terms": {
        "allocation_types": {
          "bonus": {
            "label": "string"
          },
          "clawback_recovery": {
            "label": "string"
          },
          "commission": {
            "label": "string"
          },
          "management_fee": {
            "label": "string"
          },
          "psf": {
            "label": "string"
          },
          "syndication_fee": {
            "label": "string"
          }
        },
        "bank_sources": {
          "bank_feed": {
            "label": "string"
          },
          "csv": {
            "label": "string"
          },
          "manual": {
            "label": "string"
          },
          "plaid": {
            "label": "string"
          },
          "port": {
            "label": "string"
          }
        },
        "exception_kinds": {
          "clawback_open": {
            "description": "string",
            "fix": "string",
            "label": "string"
          },
          "no_splits": {
            "description": "string",
            "fix": "string",
            "label": "string"
          },
          "on_hold": {
            "description": "string",
            "fix": "string",
            "label": "string"
          },
          "past_sla": {
            "description": "string",
            "fix": "string",
            "label": "string"
          },
          "unreconciled": {
            "description": "string",
            "fix": "string",
            "label": "string"
          }
        },
        "payout_statuses": {
          "approved": {
            "label": "string"
          },
          "cancelled": {
            "label": "string"
          },
          "paid": {
            "label": "string"
          },
          "pending": {
            "label": "string"
          },
          "rejected": {
            "label": "string"
          }
        },
        "split_bases": {
          "commission": {
            "label": "string"
          },
          "funded": {
            "label": "string"
          },
          "gross": {
            "label": "string"
          },
          "net": {
            "label": "string"
          },
          "psf": {
            "label": "string"
          }
        },
        "split_party_kinds": {
          "brokerage": {
            "label": "string"
          },
          "house": {
            "label": "string"
          },
          "lender": {
            "label": "string"
          },
          "referrer": {
            "label": "string"
          },
          "rep": {
            "label": "string"
          },
          "syndicator": {
            "label": "string"
          },
          "team_lead": {
            "label": "string"
          }
        }
      }
    },
    "vocabularies": {
      "allocation_types": [
        "string"
      ],
      "bank_sources": [
        "string"
      ],
      "exception_kinds": [
        "string"
      ],
      "payout_statuses": [
        "string"
      ],
      "split_bases": [
        "string"
      ],
      "split_party_kinds": [
        "string"
      ]
    }
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
