> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho CRM: README

> PUT /settings/fiscal_year. Includes SDK V2 and CLI requests, input constraints, response fields, and Deepline credit cost.

PUT /settings/fiscal\_year.

<Info>
  Tool ID: `zoho_crm_fiscal_year_update_fiscal_year`
</Info>

## Run this action

This action has conditional or dynamic input fields that cannot be represented by a reliable static example.

Inspect the live contract before executing it:

```bash theme={null}
deepline tools get zoho_crm_fiscal_year_update_fiscal_year --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "fiscal_year": {
      "code": "example",
      "details": {
        "id": "id_123"
      },
      "message": "Example message"
    }
  }
}
```

Use `deepline tools get zoho_crm_fiscal_year_update_fiscal_year --json` for the latest machine-readable contract.

## Input reference

Request body schema

| Name                  | Type     | Required | Default | Details             |
| --------------------- | -------- | -------- | ------- | ------------------- |
| `payload.fiscal_year` | `object` | Yes      | —       | Root key of the API |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Request body schema",
    "properties": {
      "fiscal_year": {
        "type": "object",
        "description": "Root key of the API",
        "properties": {
          "calendar_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "calendar_type of the fiscal_year can only be configured with \"gregorian\" or \"custom\" which indicates standard or custom fiscal year.",
            "maxLength": 10,
            "enum": [
              "gregorian",
              "custom"
            ]
          },
          "display_based_on": {
            "type": [
              "string",
              "null"
            ],
            "description": "Indicates whether the fiscal year label is based on the start month or end month",
            "maxLength": 20,
            "enum": [
              "start_month",
              "end_month"
            ]
          },
          "surplus_week": {
            "type": [
              "object",
              "null"
            ],
            "description": "In Custom Fiscal Year, a surplus week is an extra week added to keep the fiscal calendar aligned with the actual calendar year.",
            "properties": {
              "period": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Period of the surplus week",
                "maxLength": 1
              },
              "year": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "year of the surplus week.Can configure only for current year and the following year only",
                "maxLength": 4
              },
              "quarter": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "quarter of the surplus week",
                "maxLength": 1
              }
            },
            "additionalProperties": false
          },
          "start_month": {
            "type": [
              "string",
              "null"
            ],
            "description": "start_month is the month when the fiscal year begins. It can be configured for standard fiscal year(calendar_type = 'gregorian').",
            "maxLength": 20,
            "enum": [
              "JANUARY",
              "FEBRUARY",
              "MARCH",
              "APRIL",
              "MAY",
              "JUNE",
              "JULY",
              "AUGUST",
              "SEPTEMBER",
              "OCTOBER",
              "NOVEMBER",
              "DECEMBER"
            ]
          },
          "interval_display_option": {
            "type": [
              "string",
              "null"
            ],
            "description": "interval_display_option indicates the display format for which the periods should get displayed.",
            "maxLength": 7,
            "enum": [
              "year",
              "quarter"
            ]
          },
          "structure": {
            "type": [
              "string",
              "null"
            ],
            "description": "Structure pattern for custom fiscal year configuration. It allows 7 structures 4-4-5, 4-5-4, 5-4-4 (quarter-based) and 3-3-3-4, 3-3-4-3, 3-4-3-3, 4-3-3-3 (year-based) -- describing how weeks are distributed across \"periods\" and \"quarters\".",
            "maxLength": 10,
            "enum": [
              "4-4-5",
              "4-5-4",
              "5-4-4",
              "3-3-3-4",
              "3-3-4-3",
              "3-4-3-3",
              "4-3-3-3"
            ]
          },
          "start_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "It indicates the start_date for the custom fiscal year which can be configured only for the current year.",
            "maxLength": 10,
            "format": "date"
          }
        },
        "additionalProperties": false
      }
    },
    "required": [
      "fiscal_year"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name                                 | Type     | Required | Default | Details                                        |
| ------------------------------------ | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data`                        | `object` | Yes      | —       | Successful API operation completed             |
| `result.data.fiscal_year`            | `object` | No       | —       | Nested schema for fiscal\_year                 |
| `result.data.fiscal_year.code`       | `string` | No       | —       | Field: code Maximum length: 255.               |
| `result.data.fiscal_year.details`    | `object` | No       | —       | Nested schema for details                      |
| `result.data.fiscal_year.details.id` | `string` | No       | —       | Field: id Maximum length: 255.                 |
| `result.data.fiscal_year.message`    | `string` | No       | —       | Field: message Maximum length: 255.            |
| `result.data.fiscal_year.status`     | `string` | No       | —       | Field: status Maximum length: 255.             |
| `result.meta`                        | `object` | No       | —       | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Successful API operation completed",
        "properties": {
          "fiscal_year": {
            "type": "object",
            "description": "Nested schema for fiscal_year",
            "properties": {
              "code": {
                "type": "string",
                "description": "Field: code",
                "maxLength": 255
              },
              "details": {
                "type": "object",
                "description": "Nested schema for details",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Field: id",
                    "maxLength": 255
                  }
                },
                "additionalProperties": false
              },
              "message": {
                "type": "string",
                "description": "Field: message",
                "maxLength": 255
              },
              "status": {
                "type": "string",
                "description": "Field: status",
                "maxLength": 255
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)