---
title: "Update Fiscal Calendar"
method: PUT
path: "/tokenomics/v1/fiscal-calendar"
tags: ["tokenomics", "fiscal-calendar"]
---

# Update Fiscal Calendar

`PUT /tokenomics/v1/fiscal-calendar`

## Request body

- union
  - StructuredFiscalCalendarUpdate
    - `configuration_mode` 'structured', required
    - `configuration` StructuredFiscalCalendarConfiguration, required
      - `timezone` string, required
      - `fiscal_year_number` integer, required
      - `fiscal_year_start_date` string, date, required
      - `month_definition` union, required
        - FiscalAutomaticMonthDefinition
          - `type` 'automatic'
        - FiscalWeekPatternMonthDefinition
          - `type` 'week_pattern'
          - `pattern` 'four_four_five' | 'four_five_four' | 'five_four_four', required
          - `catch_up_months` FiscalCatchUpMonth[]
            - `fiscal_year_number` integer, required
            - `fiscal_month_number` integer, required
    - `expected_fiscal_calendar_version_id` string, uuid, required
  - JsonFiscalCalendarUpdate
    - `configuration_mode` 'json', required
    - `configuration` JsonFiscalCalendarConfiguration, required
      - `timezone` string, required
      - `week_start_day` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday', required
      - `fiscal_years` FiscalYear[], required
        - `fiscal_year_number` integer, required
        - `start_date` string, date, required
        - `end_date` string, date, required
        - `quarters` FiscalQuarter[], required
          - `fiscal_quarter_number` integer, required
          - `start_date` string, date, required
          - `end_date` string, date, required
        - `months` FiscalMonth[], required
          - `fiscal_month_number` integer, required
          - `label` string, required
          - `start_date` string, date, required
          - `end_date` string, date, required
          - `is_catch_up_month` boolean
    - `expected_fiscal_calendar_version_id` string, uuid, required

## Response `200`

Successful Response

- FiscalCalendarResponse
  - `status` 'active'
  - `active` FiscalCalendarVersion, required
    - `fiscal_calendar_version_id` string, uuid, required
    - `configuration_mode` 'structured' | 'json', required
    - `configuration` union, required
      - StructuredFiscalCalendarConfiguration
        - `timezone` string, required
        - `fiscal_year_number` integer, required
        - `fiscal_year_start_date` string, date, required
        - `month_definition` union, required
          - FiscalAutomaticMonthDefinition
            - `type` 'automatic'
          - FiscalWeekPatternMonthDefinition
            - `type` 'week_pattern'
            - `pattern` 'four_four_five' | 'four_five_four' | 'five_four_four', required
            - `catch_up_months` FiscalCatchUpMonth[]
              - …
      - JsonFiscalCalendarConfiguration
        - `timezone` string, required
        - `week_start_day` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday', required
        - `fiscal_years` FiscalYear[], required
          - `fiscal_year_number` integer, required
          - `start_date` string, date, required
          - `end_date` string, date, required
          - `quarters` FiscalQuarter[], required
            - `fiscal_quarter_number` integer, required
            - `start_date` string, date, required
            - `end_date` string, date, required
          - `months` FiscalMonth[], required
            - `fiscal_month_number` integer, required
            - `label` string, required
            - `start_date` string, date, required
            - `end_date` string, date, required
            - `is_catch_up_month` boolean
    - `source` 'system_default' | 'user_defined', required
    - `created_by` string, uuid, nullable, required
    - `activated_at` string, date-time, required
    - `deactivated_at` string, date-time, nullable, required
    - `is_active` boolean, required
    - `resolved_calendar` FiscalYear, required
      - `fiscal_year_number` integer, required
      - `start_date` string, date, required
      - `end_date` string, date, required
      - `quarters` FiscalQuarter[], required
        - `fiscal_quarter_number` integer, required
        - `start_date` string, date, required
        - `end_date` string, date, required
      - `months` FiscalMonth[], required
        - `fiscal_month_number` integer, required
        - `label` string, required
        - `start_date` string, date, required
        - `end_date` string, date, required
        - `is_catch_up_month` boolean
    - `range_options` FiscalRangeOption[], required
      - `id` 'fiscal_month_to_date' | 'fiscal_quarter_to_date' | 'fiscal_year_to_date', required
      - `label` string, required
      - `calendar_type` 'fiscal'
      - `start_date` string, date, required
      - `end_date` string, date, required

## Other responses

- `422` — Validation Error

---

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