---
title: "Updates the logged-in company settings"
method: PUT
path: "/my/company/settings"
tags: ["My"]
---

# Updates the logged-in company settings

`PUT /my/company/settings`

## Response `200`

Settings

- object
  - `data` CompanySettings
    - `id` integer — ID
    - `allow_overlapping_tools_vehicles` boolean — Vehicles and tools can be planned for multiple appointments in the same period
    - `allow_overlapping_employees` boolean — A person can be planned for multiple appointments in the same period
    - `show_sequential_custom_numbers` boolean — Activate consecutive numbers
    - `show_shareable_link` boolean — Enables sharing individual project pages to customers outside Craftboxx via link
    - `show_person_days` boolean — Display person days (PD) instead of hours / minutes
    - `force_unique_custom_numbers` boolean — Forbid identical numbers
    - `suggestions_project_contain` string — Project numbering range
    - `unplanned_assignments_app` 'HIDE' | 'SUGGEST' | 'DIRECT' — Unscheduled appointments in app
    - `unassigned_assignments_app` boolean — Also show unassigned appointments and allow self-assigning (Craftboxx 2 App only)
    - `material_change_documentation` boolean — Create "Material used" protocol entries additionally
    - `project_assignments_visibility_app` 'ASSIGNED_ONLY' | 'ALL' — Visibility of all assignments of a project in app
    - `assignments_max_start_app` 'ALL' | 'TOMORROW' | 'THREE_DAYS' | 'ONE_WEEK' | 'TWO_WEEKS' | 'FOUR_WEEKS' — Showing future appointments in app
    - `create_assignments_app` boolean — Creating appointments in app
    - `disable_timesheet_edit_app` boolean — Prevent staff from editing timesheets in app (Craftboxx 2 App only)
    - `activity_position_app` 'DISABLED' | 'REQUIRED' — GPS position handling during time tracking in the app
    - `enable_auto_break` boolean — Include automatic breaks (Craftboxx 2 App only)
    - `pdf_logo_align` 'LEFT' | 'CENTER' | 'RIGHT' — Logo position in PDF
    - `calendar_day_start` string — Opening time (calendar start)
    - `calendar_day_end` string — Closing time (calendar end)
    - `remind_assignment_start` 'NEVER' | 'FIFTEEN_MINUTES' | 'THIRTY_MINUTES' | 'ONE_HOUR' — Reminders
    - `notify_assignment_change_scope` 'TODAY_OR_TOMORROW' | 'ALL' — Period
    - `currency` 'EUR' | 'USD' | 'CHF' | 'UAH' | 'PLN' | 'RON' — Currency
    - `first_line` string — First line
    - `person_day_length` integer — Length of working day (Person-day / PD)
    - `default_holidays_per_year` integer — Holiday entitlement for new staff
    - `show_project_sales_volume` boolean — Show project sales volume and distribute it to appointments
    - `edit_project_sales_volume_in_planner` boolean — Edit project sales volume in the Planner
    - `show_target_time` boolean — Show target time in appointments
    - `edit_target_time_in_planner` boolean — Edit target time in the Planner
    - `created_at` string, date-time — Created
    - `updated_at` string, date-time — Updated

## Other responses

- `401` — The request lacks valid authentication credentials.
- `403` — The token is valid but lacks the permission for this action.
- `422` — The request was well-formed but contains semantic errors (validation failed).
- `500` — An unexpected error occurred on the server (e.g. a requested relation does not exist).

---

[API](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation.md) · [All operations](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craftboxx/craftboxx-api-documentation/revisions/e33adbfca4e8/schema)