> ## 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
> Retrieve a specific shift hour. Includes SDK V2 and CLI requests, input constraints, response fields, and Deepline credit cost.
Retrieve a specific shift hour.
Tool ID: `zoho_crm_shift_hours_get_single_shift_hour`
## Run this action
Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.
```ts theme={null}
import { Deepline } from 'deepline';
const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
'zoho_crm_shift_hours_get_single_shift_hour',
{
"shift": "example"
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={null}
deepline tools execute zoho_crm_shift_hours_get_single_shift_hour --input '{
"shift": "example"
}' --json
```
## Example response
The static output schema is not detailed enough to generate a reliable example. Use `deepline tools get zoho_crm_shift_hours_get_single_shift_hour --json` for the complete live contract.
## Input reference
Retrieves detailed information about a specific shift hour configuration including timing, breaks, users, and holidays.
| Name | Type | Required | Default | Details |
| --------------- | -------- | -------- | ------- | ------------------------------------------------------- |
| `payload.shift` | `string` | Yes | — | Unique identifier of the shift hour Maximum length: 50. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Retrieves detailed information about a specific shift hour configuration including timing, breaks, users, and holidays.",
"properties": {
"shift": {
"type": "string",
"description": "Unique identifier of the shift hour",
"maxLength": 50
}
},
"required": [
"shift"
],
"additionalProperties": false
}
```
## Output reference
Standard tool result payload.
| Name | Type | Required | Default | Details |
| ---------------------------------------------------------------------- | --------------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | — | Error scenario |
| `result.data.shift_hours` | `array` | Yes | — | List of shift hours Maximum items: 50. |
| `result.data.shift_hours[].same_as_everyday` | `boolean` | Yes | — | Same as everyday |
| `result.data.shift_hours[].shift_days` | `array` | Yes | — | Shift days Maximum items: 50. |
| `result.data.shift_hours[].daily_timing` | `array \| null` | Yes | — | Daily timing Maximum items: 50. |
| `result.data.shift_hours[].custom_timing` | `array \| null` | Yes | — | Custom timing Maximum items: 50. |
| `result.data.shift_hours[].custom_timing[].days` | `string` | Yes | — | Days Maximum length: 100. |
| `result.data.shift_hours[].custom_timing[].shift_timing` | `array` | Yes | — | Shift timing Maximum items: 50. |
| `result.data.shift_hours[].id` | `string` | Yes | — | Unique identifier Maximum length: 100. |
| `result.data.shift_hours[].break_hours` | `array \| null` | Yes | — | Break hours Maximum items: 50. |
| `result.data.shift_hours[].break_hours[].same_as_everyday` | `boolean` | Yes | — | Same as everyday |
| `result.data.shift_hours[].break_hours[].break_days` | `array` | Yes | — | Break days Maximum items: 50. |
| `result.data.shift_hours[].break_hours[].daily_timing` | `array` | Yes | — | Daily timing Maximum items: 50. |
| `result.data.shift_hours[].break_hours[].custom_timing` | `array \| null` | Yes | — | Custom timing Maximum items: 50. |
| `result.data.shift_hours[].break_hours[].custom_timing[].days` | `string` | Yes | — | Days Maximum length: 100. |
| `result.data.shift_hours[].break_hours[].custom_timing[].break_timing` | `array` | Yes | — | Break timing Maximum items: 50. |
| `result.data.shift_hours[].break_hours[].id` | `string` | Yes | — | Unique identifier Maximum length: 100. |
| `result.data.shift_hours[].users` | `array \| null` | Yes | — | Users Maximum items: 50. |
| `result.data.shift_hours[].users[].role` | `object` | Yes | — | Role |
| `result.data.shift_hours[].users[].role.name` | `string` | Yes | — | Name Maximum length: 100. |
| `result.data.shift_hours[].users[].role.id` | `string` | Yes | — | Unique identifier Maximum length: 100. |
| `result.data.shift_hours[].users[].name` | `string` | Yes | — | Name Maximum length: 100. |
| `result.data.shift_hours[].users[].id` | `string` | Yes | — | Unique identifier Maximum length: 100. |
| `result.data.shift_hours[].users[].email` | `string` | Yes | — | Email Maximum length: 100. |
| `result.data.shift_hours[].users[].zuid` | `string` | Yes | — | Zuid Maximum length: 100. |
| `result.data.shift_hours[].users[].effective_from` | `string` | Yes | — | Effective from Format: `date`. |
| `result.data.shift_hours[].holidays` | `array \| null` | Yes | — | Holidays Maximum items: 50. |
| `result.data.shift_hours[].holidays[].date` | `string` | Yes | — | Date Format: `date`. |
| `result.data.shift_hours[].holidays[].year` | `record` | Yes | — | Year |
| `result.data.shift_hours[].holidays[].name` | `string` | Yes | — | Name Maximum length: 100. |
| `result.data.shift_hours[].holidays[].id` | `string` | Yes | — | Unique identifier Maximum length: 100. |
| `result.data.shift_hours[].holidays[].userFmt` | `string` | Yes | — | Userfmt Maximum length: 100. |
| `result.data.shift_hours[].users_count` | `integer` | Yes | — | Users count Format: `int32`. |
| `result.data.shift_hours[].timezone` | `string` | Yes | — | Timezone Maximum length: 100. |
| `result.data.shift_hours[].name` | `string` | Yes | — | Name Maximum length: 100. |
| `result.data.shift_count` | `object` | Yes | — | Shift count |
| `result.data.shift_count.total_shift_with_user` | `integer` | Yes | — | Total shift with user Format: `int32`. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Error scenario",
"properties": {
"shift_hours": {
"type": "array",
"description": "List of shift hours",
"maxItems": 50,
"items": {
"type": "object",
"description": "Item details",
"properties": {
"same_as_everyday": {
"type": "boolean",
"description": "Same as everyday"
},
"shift_days": {
"type": "array",
"description": "Shift days",
"maxItems": 50,
"items": {
"type": "string",
"description": "Shift days",
"enum": [
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday",
"Sunday"
]
}
},
"daily_timing": {
"type": [
"array",
"null"
],
"description": "Daily timing",
"maxItems": 50,
"items": {
"type": "string",
"description": "Daily timing",
"maxLength": 5,
"pattern": "^([0-1][0-9]|2[0-3]):[0-5][0-9]$"
}
},
"custom_timing": {
"type": [
"array",
"null"
],
"description": "Custom timing",
"maxItems": 50,
"items": {
"type": "object",
"description": "Item details",
"properties": {
"days": {
"type": "string",
"description": "Days",
"maxLength": 100
},
"shift_timing": {
"type": "array",
"description": "Shift timing",
"maxItems": 50,
"items": {
"type": "string",
"description": "Shift timing",
"maxLength": 5,
"pattern": "^([0-1][0-9]|2[0-3]):[0-5][0-9]$"
}
}
},
"required": [
"days",
"shift_timing"
],
"additionalProperties": false
}
},
"id": {
"type": "string",
"description": "Unique identifier",
"maxLength": 100
},
"break_hours": {
"type": [
"array",
"null"
],
"description": "Break hours",
"maxItems": 50,
"items": {
"type": "object",
"description": "Item details",
"properties": {
"same_as_everyday": {
"type": "boolean",
"description": "Same as everyday"
},
"break_days": {
"type": "array",
"description": "Break days",
"maxItems": 50,
"items": {
"type": "string",
"description": "Break days",
"maxLength": 100
}
},
"daily_timing": {
"type": "array",
"description": "Daily timing",
"maxItems": 50,
"items": {
"type": "string",
"description": "Daily timing",
"maxLength": 5,
"pattern": "^([0-1][0-9]|2[0-3]):[0-5][0-9]$"
}
},
"custom_timing": {
"type": [
"array",
"null"
],
"description": "Custom timing",
"maxItems": 50,
"items": {
"type": "object",
"description": "Item details",
"properties": {
"days": {
"type": "string",
"description": "Days",
"maxLength": 100
},
"break_timing": {
"type": "array",
"description": "Break timing",
"maxItems": 50,
"items": {
"type": "string",
"description": "Break timing",
"maxLength": 5,
"pattern": "^([0-1][0-9]|2[0-3]):[0-5][0-9]$"
}
}
},
"required": [
"days",
"break_timing"
],
"additionalProperties": false
}
},
"id": {
"type": "string",
"description": "Unique identifier",
"maxLength": 100
}
},
"required": [
"same_as_everyday",
"break_days",
"daily_timing",
"custom_timing",
"id"
],
"additionalProperties": false
}
},
"users": {
"type": [
"array",
"null"
],
"description": "Users",
"maxItems": 50,
"items": {
"type": "object",
"description": "Item details",
"properties": {
"role": {
"type": "object",
"description": "Role",
"properties": {
"name": {
"type": "string",
"description": "Name",
"maxLength": 100
},
"id": {
"type": "string",
"description": "Unique identifier",
"maxLength": 100
}
},
"required": [
"name",
"id"
],
"additionalProperties": false
},
"name": {
"type": "string",
"description": "Name",
"maxLength": 100
},
"id": {
"type": "string",
"description": "Unique identifier",
"maxLength": 100
},
"email": {
"type": "string",
"description": "Email",
"maxLength": 100
},
"zuid": {
"type": "string",
"description": "Zuid",
"maxLength": 100
},
"effective_from": {
"type": "string",
"description": "Effective from",
"format": "date"
}
},
"required": [
"role",
"name",
"id",
"email",
"zuid",
"effective_from"
],
"additionalProperties": false
}
},
"holidays": {
"type": [
"array",
"null"
],
"description": "Holidays",
"maxItems": 50,
"items": {
"type": "object",
"description": "Item details",
"properties": {
"date": {
"type": "string",
"description": "Date",
"format": "date"
},
"year": {
"type": "object",
"description": "Year",
"additionalProperties": false
},
"name": {
"type": "string",
"description": "Name",
"maxLength": 100
},
"id": {
"type": "string",
"description": "Unique identifier",
"maxLength": 100
},
"userFmt": {
"type": "string",
"description": "Userfmt",
"maxLength": 100
}
},
"required": [
"date",
"year",
"name",
"id",
"userFmt"
],
"additionalProperties": false
}
},
"users_count": {
"type": "integer",
"description": "Users count",
"format": "int32"
},
"timezone": {
"type": "string",
"description": "Timezone",
"maxLength": 100
},
"name": {
"type": "string",
"description": "Name",
"maxLength": 100
}
},
"required": [
"same_as_everyday",
"shift_days",
"daily_timing",
"custom_timing",
"id",
"break_hours",
"users",
"holidays",
"users_count",
"timezone",
"name"
],
"additionalProperties": false
}
},
"shift_count": {
"type": "object",
"description": "Shift count",
"properties": {
"total_shift_with_user": {
"type": "integer",
"description": "Total shift with user",
"format": "int32"
}
},
"required": [
"total_shift_with_user"
],
"additionalProperties": false
}
},
"required": [
"shift_hours",
"shift_count"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## 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)