---
title: "Set time tracking settings"
method: PUT
path: "/rest/api/3/configuration/timetracking/options"
tags: ["Time tracking"]
---

# Set time tracking settings

`PUT /rest/api/3/configuration/timetracking/options`

Sets the time tracking settings.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Request body

- TimeTrackingConfiguration — Details of the time tracking configuration.
  - `defaultUnit` 'minute' | 'hour' | 'day' | 'week', required — The default unit of time applied to logged time.
  - `timeFormat` 'pretty' | 'days' | 'hours', required — The format that will appear on an issue's *Time Spent* field.
  - `workingDaysPerWeek` number, double, required — The number of days in a working week.
  - `workingHoursPerDay` number, double, required — The number of hours in a working day.

## Response `200`

Returned if the request is successful.

- TimeTrackingConfiguration — Details of the time tracking configuration.
  - `defaultUnit` 'minute' | 'hour' | 'day' | 'week', required — The default unit of time applied to logged time.
  - `timeFormat` 'pretty' | 'days' | 'hours', required — The format that will appear on an issue's *Time Spent* field.
  - `workingDaysPerWeek` number, double, required — The number of days in a working week.
  - `workingHoursPerDay` number, double, required — The number of hours in a working day.

## Other responses

- `400` — Returned if the request object is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the necessary permission.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)