{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Tasks",
  "description": "Tasks are the to-dos that you and your users have to complete. You can set reminders for tasks that need your attention. Reminders help you stay organized by alerting you about due or upcoming tasks.",
  "definitions": {
    "task_id": {
      "description": "ID of the task.",
      "type": "string",
      "example": 982000000567114
    },
    "recurring_task_id": {
      "description": "ID of the recurring task.",
      "type": "string",
      "example": 982000000567115
    },
    "owner_id": {
      "description": "ID of the owner of the task.",
      "type": "string",
      "example": 982000000567116
    },
    "owner_ids": {
      "description": "Comma separated list of owner IDs of the task.",
      "type": "string",
      "example": "982000000567116,982000000567117"
    },
    "owner_name": {
      "description": "Name of the owner of the task.",
      "type": "string",
      "example": "John Doe"
    },
    "owners": {
      "description": "List of owners of the task.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "owner_id": {
            "$ref": "#/components/schemas/owner_id"
          },
          "owner_name": {
            "$ref": "#/components/schemas/owner_name"
          },
          "owner_mail": {
            "description": "Email of the owner of the task.",
            "type": "string",
            "example": "johndoe@example.com"
          },
          "photo_url": {
            "description": "URL of the photo of the owner of the task.",
            "type": "string",
            "example": "https://example.com/photo.jpg"
          }
        }
      }
    },
    "title": {
      "description": "Title of the task.",
      "type": "string",
      "example": "Sample Task"
    },
    "due_date": {
      "description": "Due date of the task.",
      "type": "string",
      "format": "date",
      "example": "2025-12-31"
    },
    "due_date_formatted": {
      "description": "Formatted due date of the task.",
      "type": "string",
      "example": "31-12-2025"
    },
    "is_overdue": {
      "description": "Indicates whether the task is overdue.",
      "type": "boolean",
      "example": true
    },
    "contact_type": {
      "description": "Type of the contact associated with the task. Allowed values are <code>customer</code> and <code>vendor</code>",
      "type": "string",
      "example": "customer"
    },
    "contact_id": {
      "description": "ID of the contact associated with the task.",
      "type": "string",
      "example": 982000000567118
    },
    "color_code": {
      "description": "Color code of the task.",
      "type": "string",
      "example": "#FF5733"
    },
    "contact_name": {
      "description": "Name of the contact associated with the task.",
      "type": "string",
      "example": "Jane Smith"
    },
    "parent_task_id": {
      "description": "ID of the parent task.",
      "type": "string",
      "example": 982000000567119
    },
    "related_entity_id": {
      "description": "ID of the related entity associated with the task.",
      "type": "string",
      "example": 982000000567120
    },
    "related_entity_type": {
      "description": "Type of the related entity associated with the task.",
      "type": "string",
      "example": "invoice"
    },
    "related_entity": {
      "description": "Unique value assigned to each entity.",
      "type": "integer",
      "example": 20
    },
    "related_entity_value": {
      "description": "Value of the related entity associated with the task.",
      "type": "string",
      "example": "INV-001"
    },
    "parent_status": {
      "description": "Parent status of the task.",
      "type": "string",
      "example": "open"
    },
    "status": {
      "description": "Status of the task.",
      "type": "string",
      "example": "open"
    },
    "custom_status_id": {
      "description": "ID of the custom status of the task.",
      "type": "string",
      "example": 982000000567121
    },
    "billing_type": {
      "description": "Billing type of the task.",
      "type": "string",
      "example": "based_on_task_hours"
    },
    "is_billable": {
      "description": "Indicates whether the task is billable.",
      "type": "boolean",
      "example": true
    },
    "task_rate": {
      "description": "Rate of the task.",
      "type": "number",
      "format": "double",
      "example": 50
    },
    "completion_percentage": {
      "description": "Completion percentage of the task.",
      "type": "integer",
      "example": 75
    },
    "is_subtask": {
      "description": "Indicates whether the task is a subtask.",
      "type": "boolean",
      "example": false
    },
    "priority": {
      "description": "Priority of the task. Allowed values are <code>normal</code>, <code>low</code>, <code>high</code>, <code>lowest</code> and <code>highest</code>",
      "type": "string",
      "example": "high"
    },
    "reminder": {
      "description": "Details of the reminder set for the task.",
      "type": "object",
      "properties": {
        "remind_before": {
          "description": "Number of days, months or years before the task due date to send a reminder.",
          "type": "integer",
          "example": 2
        },
        "remind_at": {
          "description": "Specific date to send the reminder.",
          "type": "string",
          "format": "date",
          "example": "2025-12-29"
        },
        "remind_at_formatted": {
          "description": "Formatted date to send the reminder.",
          "type": "string",
          "example": "29-12-2025"
        },
        "remind_type": {
          "description": "Type of reminder which can be days, months or years.",
          "type": "string",
          "example": "days"
        },
        "remind_type_formatted": {
          "description": "Formatted type of reminder which can be days, months or years.",
          "type": "string",
          "example": "Days"
        },
        "alert_type": {
          "description": "Type of alert for the reminder.",
          "type": "string",
          "example": "email"
        },
        "alert_type_formatted": {
          "description": "Formatted type of alert for the reminder.",
          "type": "string",
          "example": "Email"
        }
      }
    },
    "send_email_notification": {
      "description": "Indicates whether to send email notification for the task.",
      "type": "boolean",
      "example": true
    },
    "mail_id": {
      "description": "Email ID to which the notification has to be sent.",
      "type": "string",
      "example": "johndoe@gmail.com"
    },
    "email_account_type": {
      "description": "Email account type to which the notification has to be sent.",
      "type": "string",
      "example": "gmail"
    },
    "email_folder_id": {
      "description": "Folder ID of the email account to which the notification has to be sent.",
      "type": "string",
      "example": "982000000567126"
    },
    "email_account_id": {
      "description": "Email account ID to which the notification has to be sent.",
      "type": "string",
      "example": "982000000567127"
    },
    "mail_attachments": {
      "description": "List of attachments to be sent along with the email notification.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "attachment_id": {
            "description": "ID of the attachment to be sent along with the email notification.",
            "type": "string",
            "example": "982000000567128"
          },
          "file_name": {
            "description": "Name of the file attached to the email notification.",
            "type": "string",
            "example": "document.pdf"
          }
        }
      }
    },
    "task_type": {
      "description": "Type of the task.",
      "type": "string",
      "example": "accountant task"
    },
    "is_sub_task": {
      "description": "Indicates whether the task is a sub task.",
      "type": "boolean",
      "example": false
    },
    "subtask_count": {
      "description": "Number of subtasks under the task.",
      "type": "integer",
      "example": 3
    },
    "related_sub_entity_id": {
      "description": "ID of the related sub entity associated with the task.",
      "type": "string",
      "example": 982000000567122
    },
    "related_sub_entity_type": {
      "description": "Type of the related sub entity associated with the task.",
      "type": "string",
      "example": "expense_report"
    },
    "client_id": {
      "description": "ID of the client associated with the task.",
      "type": "string",
      "example": 982000000567118
    },
    "client_name": {
      "description": "Name of the client associated with the task.",
      "type": "string",
      "example": "Acme Corporation"
    },
    "task_description": {
      "description": "Description of the task.",
      "type": "string",
      "example": "This is a sample task description."
    },
    "is_accountant_task": {
      "description": "Indicates whether the task is an accountant task.",
      "type": "boolean",
      "example": false
    },
    "task_number": {
      "description": "Unique number assigned to the task.",
      "type": "string",
      "example": "T-001"
    },
    "task_number_prefix": {
      "description": "Prefix of the task number.",
      "type": "string",
      "example": "T-"
    },
    "task_number_suffix": {
      "description": "Suffix of the task number.",
      "type": "string",
      "example": "-001"
    },
    "can_push": {
      "description": "Indicates if the task can be sync to client",
      "type": "boolean",
      "example": true
    },
    "created_by_id": {
      "description": "ID of the user who created the task.",
      "type": "string",
      "example": 982000000567122
    },
    "last_modified_by_id": {
      "description": "ID of the user who last modified the task.",
      "type": "string",
      "example": 982000000567123
    },
    "created_time": {
      "description": "Creation time of the task.",
      "type": "string",
      "format": "date-time",
      "example": "2025-01-01T10:00:00Z"
    },
    "created_time_formatted": {
      "description": "Formatted creation time of the task.",
      "type": "string",
      "example": "01-01-2025 10:00:00"
    },
    "template_id": {
      "description": "ID of the template used for the task.",
      "type": "string",
      "example": 982000000567124
    },
    "due_after": {
      "description": "Number of days after which the task is due.",
      "type": "integer",
      "example": 7
    },
    "parent_task_name": {
      "description": "Name of the parent task.",
      "type": "string",
      "example": "Parent Task"
    },
    "parent_task_number": {
      "description": "Number of the parent task.",
      "type": "string",
      "example": "PT-001"
    },
    "created_by_name": {
      "description": "Name of the user who created the task.",
      "type": "string",
      "example": "John Doe"
    },
    "can_show_in_portal": {
      "description": "Indicates whether the document can be shown in the customer portal.",
      "type": "boolean",
      "example": true
    },
    "file_name": {
      "description": "Name of the file attached to the task.",
      "type": "string",
      "example": "document.pdf"
    },
    "file_type": {
      "description": "Type of the file attached to the task.",
      "type": "string",
      "example": "pdf"
    },
    "file_size": {
      "description": "Size of the file attached to the task in bytes.",
      "type": "integer",
      "example": 204800
    },
    "file_size_formatted": {
      "description": "Formatted size of the file attached to the task.",
      "type": "string",
      "example": "200 KB"
    },
    "document_id": {
      "description": "ID of the document attached to the task.",
      "type": "string",
      "example": 982000000567125
    },
    "attachment_order": {
      "description": "Order of the attachment in the task.",
      "type": "integer",
      "example": 1
    },
    "document": {
      "description": "Details of the document attached to the task.",
      "type": "object",
      "properties": {
        "can_show_in_portal": {
          "$ref": "#/components/schemas/can_show_in_portal"
        },
        "file_name": {
          "$ref": "#/components/schemas/file_name"
        },
        "file_type": {
          "$ref": "#/components/schemas/file_type"
        },
        "file_size": {
          "$ref": "#/components/schemas/file_size"
        },
        "file_size_formatted": {
          "$ref": "#/components/schemas/file_size_formatted"
        },
        "document_id": {
          "$ref": "#/components/schemas/document_id"
        },
        "attachment_order": {
          "$ref": "#/components/schemas/attachment_order"
        }
      }
    },
    "documents": {
      "description": "List of files attached to a particular task.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "can_show_in_portal": {
            "$ref": "#/components/schemas/can_show_in_portal"
          },
          "file_name": {
            "$ref": "#/components/schemas/file_name"
          },
          "file_type": {
            "$ref": "#/components/schemas/file_type"
          },
          "file_size": {
            "$ref": "#/components/schemas/file_size"
          },
          "file_size_formatted": {
            "$ref": "#/components/schemas/file_size_formatted"
          },
          "document_id": {
            "$ref": "#/components/schemas/document_id"
          },
          "attachment_order": {
            "$ref": "#/components/schemas/attachment_order"
          }
        }
      }
    },
    "custom_fields": {
      "type": "array",
      "description": "List of custom fields associated with the task",
      "items": {
        "type": "object",
        "properties": {
          "customfield_id": {
            "type": "string",
            "description": "Unique identifier of the custom field",
            "example": "46000000012845"
          },
          "edit_on_store": {
            "type": "boolean",
            "description": "Whether the custom field can be edited on store",
            "example": "false"
          },
          "show_in_all_pdf": {
            "type": "boolean",
            "description": "Whether to show this custom field in all PDF documents",
            "example": "true"
          },
          "search_entity": {
            "type": "string",
            "description": "Entity type to search when this is a lookup field",
            "example": "contacts"
          },
          "value": {
            "type": "object",
            "description": "Value of the custom field, could be of any data type",
            "example": "Value123"
          },
          "value_formatted": {
            "type": "string",
            "description": "Formatted string representation of the value",
            "example": "Value123"
          },
          "show_in_store": {
            "type": "boolean",
            "description": "Whether to show this custom field in store",
            "example": "false"
          },
          "is_active": {
            "type": "boolean",
            "description": "Whether the custom field is active",
            "example": "true"
          },
          "order": {
            "type": "integer",
            "description": "Display order of the custom field",
            "example": "1"
          },
          "label": {
            "type": "string",
            "description": "Display name of the custom field",
            "example": "Project Code"
          },
          "api_name": {
            "type": "string",
            "description": "API name of the field",
            "example": "cf_project_code"
          },
          "data_type": {
            "type": "string",
            "description": "Data type of the custom field",
            "example": "text"
          },
          "is_dependent_field": {
            "type": "boolean",
            "description": "Whether the custom field depends on another field",
            "example": "false"
          },
          "show_in_portal": {
            "type": "boolean",
            "description": "Whether to show this custom field in the customer portal",
            "example": "true"
          },
          "show_on_pdf": {
            "type": "boolean",
            "description": "Whether to show this custom field in PDF documents",
            "example": "true"
          },
          "edit_on_portal": {
            "type": "boolean",
            "description": "Whether the custom field can be edited on the customer portal",
            "example": "false"
          }
        }
      }
    },
    "statuses": {
      "description": "List of statuses for the task.",
      "type": "array",
      "items": {
        "type": "string"
      },
      "example": [
        "open",
        "closed",
        "pending"
      ]
    },
    "is_system_task": {
      "description": "Indicates whether the task is a system task.",
      "type": "boolean",
      "example": false
    },
    "system_task_type": {
      "description": "Type of the system task.",
      "type": "integer",
      "example": 2
    },
    "comment_id": {
      "description": "ID of the comment on the task.",
      "type": "string",
      "example": 982000000567126
    },
    "commented_by_id": {
      "description": "ID of the user who commented on the task.",
      "type": "string",
      "example": 982000000567127
    },
    "commented_by": {
      "description": "Name of the user who commented on the task.",
      "type": "string",
      "example": "Jane Doe"
    },
    "comment_type": {
      "description": "Type of the comment.",
      "type": "string",
      "example": "internal"
    },
    "date_description": {
      "description": "Description of the date when the comment was made.",
      "type": "string",
      "example": "One month ago"
    },
    "time": {
      "description": "Time when the comment was made.",
      "type": "string",
      "example": "12:00 PM"
    },
    "operation_type": {
      "description": "Type of operation performed on the task.",
      "type": "string",
      "example": "Added"
    },
    "transaction_id": {
      "description": "ID of the transaction associated with the task.",
      "type": "string",
      "example": 982000000567128
    },
    "transaction_type": {
      "description": "Type of transaction associated with the task.",
      "type": "string",
      "example": "invoice"
    },
    "description": {
      "description": "Description of the comment.",
      "type": "string",
      "example": "This is a sample comment."
    },
    "comment": {
      "description": "Comment on the task.",
      "type": "object",
      "properties": {
        "comment_id": {
          "$ref": "#/components/schemas/comment_id"
        },
        "description": {
          "$ref": "#/components/schemas/description"
        },
        "commented_by_id": {
          "$ref": "#/components/schemas/commented_by_id"
        },
        "commented_by": {
          "$ref": "#/components/schemas/commented_by"
        },
        "comment_type": {
          "$ref": "#/components/schemas/comment_type"
        },
        "date": {
          "description": "Date when the comment was made.",
          "type": "string",
          "format": "date-time",
          "example": "2025-01-01T12:00:00Z"
        },
        "date_description": {
          "$ref": "#/components/schemas/date_description"
        },
        "time": {
          "$ref": "#/components/schemas/time"
        },
        "operation_type": {
          "$ref": "#/components/schemas/operation_type"
        },
        "transaction_id": {
          "$ref": "#/components/schemas/transaction_id"
        },
        "transaction_type": {
          "$ref": "#/components/schemas/transaction_type"
        }
      }
    },
    "comments": {
      "description": "List of comments for the task.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "comment_id": {
            "$ref": "#/components/schemas/comment_id"
          },
          "description": {
            "description": "Description of the comment.",
            "type": "string",
            "example": "This is a sample comment."
          },
          "commented_by_id": {
            "$ref": "#/components/schemas/commented_by_id"
          },
          "commented_by": {
            "$ref": "#/components/schemas/commented_by"
          },
          "comment_type": {
            "$ref": "#/components/schemas/comment_type"
          },
          "date": {
            "description": "Date when the comment was made.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-01T12:00:00Z"
          },
          "date_description": {
            "$ref": "#/components/schemas/date_description"
          },
          "time": {
            "$ref": "#/components/schemas/time"
          },
          "operation_type": {
            "$ref": "#/components/schemas/operation_type"
          },
          "transaction_id": {
            "$ref": "#/components/schemas/transaction_id"
          },
          "transaction_type": {
            "$ref": "#/components/schemas/transaction_type"
          }
        }
      }
    },
    "parent_id": {
      "description": "ID of the parent task.",
      "type": "string",
      "example": 982000000567114
    },
    "entity_tags": {
      "description": "List of tags associated with the task.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "ID of the tag.",
            "type": "string",
            "example": 982000000567129
          },
          "name": {
            "description": "Name of the tag.",
            "type": "string",
            "example": "Important"
          },
          "color": {
            "description": "Color code of the tag.",
            "type": "string",
            "example": "FFB6C1"
          }
        }
      }
    },
    "dependencies": {
      "description": "List of dependencies for the task.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "dependency_id": {
            "description": "ID of the dependency.",
            "type": "string",
            "example": 982000000567192
          },
          "dependency_type": {
            "description": "Type of the dependency.",
            "type": "integer",
            "example": 1
          },
          "depends_on_id": {
            "description": "ID of the entity on which the current task depends.",
            "type": "string",
            "example": 982000000567193
          },
          "depends_on_entity_type": {
            "description": "Type of the entity on which the current task depends.",
            "type": "integer",
            "example": 20
          }
        }
      }
    },
    "gendoc-attributes-schema": {
      "type": "object",
      "properties": {
        "task_id": {
          "$ref": "#/components/schemas/task_id"
        },
        "recurring_task_id": {
          "$ref": "#/components/schemas/recurring_task_id"
        },
        "owner_id": {
          "$ref": "#/components/schemas/owner_id"
        },
        "owner_ids": {
          "$ref": "#/components/schemas/owner_ids"
        },
        "owner_name": {
          "$ref": "#/components/schemas/owner_name"
        },
        "owners": {
          "$ref": "#/components/schemas/owners"
        },
        "title": {
          "$ref": "#/components/schemas/title"
        },
        "due_date": {
          "$ref": "#/components/schemas/due_date"
        },
        "due_date_formatted": {
          "$ref": "#/components/schemas/due_date_formatted"
        },
        "is_overdue": {
          "$ref": "#/components/schemas/is_overdue"
        },
        "contact_type": {
          "$ref": "#/components/schemas/contact_type"
        },
        "contact_id": {
          "$ref": "#/components/schemas/contact_id"
        },
        "color_code": {
          "$ref": "#/components/schemas/color_code"
        },
        "contact_name": {
          "$ref": "#/components/schemas/contact_name"
        },
        "parent_task_id": {
          "$ref": "#/components/schemas/parent_task_id"
        },
        "related_entity_id": {
          "$ref": "#/components/schemas/related_entity_id"
        },
        "related_entity_type": {
          "$ref": "#/components/schemas/related_entity_type"
        },
        "related_entity": {
          "$ref": "#/components/schemas/related_entity"
        },
        "related_entity_value": {
          "$ref": "#/components/schemas/related_entity_value"
        },
        "parent_status": {
          "$ref": "#/components/schemas/parent_status"
        },
        "status": {
          "$ref": "#/components/schemas/status"
        },
        "custom_status_id": {
          "$ref": "#/components/schemas/custom_status_id"
        },
        "billing_type": {
          "$ref": "#/components/schemas/billing_type"
        },
        "is_billable": {
          "$ref": "#/components/schemas/is_billable"
        },
        "task_rate": {
          "$ref": "#/components/schemas/task_rate"
        },
        "completion_percentage": {
          "$ref": "#/components/schemas/completion_percentage"
        },
        "is_subtask": {
          "$ref": "#/components/schemas/is_subtask"
        },
        "priority": {
          "$ref": "#/components/schemas/priority"
        },
        "reminder": {
          "$ref": "#/components/schemas/reminder"
        },
        "task_description": {
          "$ref": "#/components/schemas/task_description"
        },
        "is_accountant_task": {
          "$ref": "#/components/schemas/is_accountant_task"
        },
        "task_number": {
          "$ref": "#/components/schemas/task_number"
        },
        "task_number_prefix": {
          "$ref": "#/components/schemas/task_number_prefix"
        },
        "task_number_suffix": {
          "$ref": "#/components/schemas/task_number_suffix"
        },
        "can_push": {
          "$ref": "#/components/schemas/can_push"
        },
        "created_by_id": {
          "$ref": "#/components/schemas/created_by_id"
        },
        "last_modified_by_id": {
          "$ref": "#/components/schemas/last_modified_by_id"
        },
        "template_id": {
          "$ref": "#/components/schemas/template_id"
        },
        "due_after": {
          "$ref": "#/components/schemas/due_after"
        },
        "parent_task_name": {
          "$ref": "#/components/schemas/parent_task_name"
        },
        "parent_task_number": {
          "$ref": "#/components/schemas/parent_task_number"
        },
        "created_by_name": {
          "$ref": "#/components/schemas/created_by_name"
        }
      }
    },
    "add-a-task-request": {
      "type": "object",
      "properties": {
        "task_id": {
          "$ref": "#/components/schemas/task_id"
        },
        "owner_ids": {
          "$ref": "#/components/schemas/owner_ids"
        },
        "owner_id": {
          "$ref": "#/components/schemas/owner_id"
        },
        "task_type": {
          "$ref": "#/components/schemas/task_type"
        },
        "title": {
          "$ref": "#/components/schemas/title"
        },
        "due_date": {
          "$ref": "#/components/schemas/due_date"
        },
        "contact_type": {
          "$ref": "#/components/schemas/contact_type"
        },
        "contact_id": {
          "$ref": "#/components/schemas/contact_id"
        },
        "can_push": {
          "$ref": "#/components/schemas/can_push"
        },
        "related_entity_type": {
          "$ref": "#/components/schemas/related_entity_type"
        },
        "related_entity_id": {
          "$ref": "#/components/schemas/related_entity_id"
        },
        "related_sub_entity_type": {
          "$ref": "#/components/schemas/related_sub_entity_type"
        },
        "related_sub_entity_id": {
          "$ref": "#/components/schemas/related_sub_entity_id"
        },
        "status": {
          "$ref": "#/components/schemas/status"
        },
        "billing_type": {
          "$ref": "#/components/schemas/billing_type"
        },
        "is_billable": {
          "$ref": "#/components/schemas/is_billable"
        },
        "task_rate": {
          "$ref": "#/components/schemas/task_rate"
        },
        "completion_percentage": {
          "$ref": "#/components/schemas/completion_percentage"
        },
        "priority": {
          "$ref": "#/components/schemas/priority"
        },
        "send_email_notification": {
          "$ref": "#/components/schemas/send_email_notification"
        },
        "mail_id": {
          "$ref": "#/components/schemas/mail_id"
        },
        "email_account_type": {
          "$ref": "#/components/schemas/email_account_type"
        },
        "email_folder_id": {
          "$ref": "#/components/schemas/email_folder_id"
        },
        "email_account_id": {
          "$ref": "#/components/schemas/email_account_id"
        },
        "mail_attachments": {
          "$ref": "#/components/schemas/mail_attachments"
        },
        "reminder": {
          "$ref": "#/components/schemas/reminder"
        },
        "task_description": {
          "$ref": "#/components/schemas/task_description"
        },
        "custom_fields": {
          "type": "array",
          "description": "List of custom fields associated with the task",
          "items": {
            "type": "object",
            "properties": {
              "customfield_id": {
                "description": "ID of the custom field.",
                "type": "string",
                "example": 982000000567114
              },
              "index": {
                "description": "Index of the custom field.",
                "type": "integer",
                "example": 1
              },
              "label": {
                "description": "Label of the custom field.",
                "type": "string",
                "example": "Custom Field Label"
              },
              "value": {
                "description": "Value of the custom field.",
                "type": "string",
                "example": "Custom Field Value"
              },
              "value_formatted": {
                "description": "Formatted value of the custom field.",
                "type": "string",
                "example": "Formatted Custom Field Value"
              },
              "api_name": {
                "description": "Name of the custom field.",
                "type": "string",
                "example": "CustomFieldAPIName"
              }
            }
          }
        },
        "due_after": {
          "$ref": "#/components/schemas/due_after"
        },
        "template_id": {
          "$ref": "#/components/schemas/template_id"
        },
        "task_number": {
          "$ref": "#/components/schemas/task_number"
        },
        "task_number_prefix": {
          "$ref": "#/components/schemas/task_number_prefix"
        },
        "task_number_suffix": {
          "$ref": "#/components/schemas/task_number_suffix"
        },
        "recurring_task_id": {
          "$ref": "#/components/schemas/recurring_task_id"
        },
        "is_sub_task": {
          "$ref": "#/components/schemas/is_sub_task"
        },
        "parent_id": {
          "$ref": "#/components/schemas/parent_id"
        },
        "dependencies": {
          "$ref": "#/components/schemas/dependencies"
        },
        "entity_tags": {
          "description": "List of tags to be associated with the task.",
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "description": "Name of the tag.",
                "type": "string",
                "example": "Important"
              },
              "color": {
                "description": "Color code of the tag.",
                "type": "string",
                "example": "FFB6C1"
              }
            }
          }
        }
      }
    },
    "add-a-task-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Task created",
          "readOnly": true
        },
        "task": {
          "type": "object",
          "properties": {
            "task_id": {
              "$ref": "#/components/schemas/task_id"
            },
            "recurring_task_id": {
              "$ref": "#/components/schemas/recurring_task_id"
            },
            "owner_id": {
              "$ref": "#/components/schemas/owner_id"
            },
            "owner_ids": {
              "$ref": "#/components/schemas/owner_ids"
            },
            "owner_name": {
              "$ref": "#/components/schemas/owner_name"
            },
            "owners": {
              "$ref": "#/components/schemas/owners"
            },
            "title": {
              "$ref": "#/components/schemas/title"
            },
            "due_date": {
              "$ref": "#/components/schemas/due_date"
            },
            "due_date_formatted": {
              "$ref": "#/components/schemas/due_date_formatted"
            },
            "is_overdue": {
              "$ref": "#/components/schemas/is_overdue"
            },
            "contact_type": {
              "$ref": "#/components/schemas/contact_type"
            },
            "contact_id": {
              "$ref": "#/components/schemas/contact_id"
            },
            "color_code": {
              "$ref": "#/components/schemas/color_code"
            },
            "contact_name": {
              "$ref": "#/components/schemas/contact_name"
            },
            "parent_task_id": {
              "$ref": "#/components/schemas/parent_task_id"
            },
            "related_entity_id": {
              "$ref": "#/components/schemas/related_entity_id"
            },
            "related_entity_type": {
              "$ref": "#/components/schemas/related_entity_type"
            },
            "related_entity": {
              "$ref": "#/components/schemas/related_entity"
            },
            "related_entity_value": {
              "$ref": "#/components/schemas/related_entity_value"
            },
            "parent_status": {
              "$ref": "#/components/schemas/parent_status"
            },
            "status": {
              "$ref": "#/components/schemas/status"
            },
            "custom_status_id": {
              "$ref": "#/components/schemas/custom_status_id"
            },
            "billing_type": {
              "$ref": "#/components/schemas/billing_type"
            },
            "is_billable": {
              "$ref": "#/components/schemas/is_billable"
            },
            "task_rate": {
              "$ref": "#/components/schemas/task_rate"
            },
            "completion_percentage": {
              "$ref": "#/components/schemas/completion_percentage"
            },
            "is_subtask": {
              "$ref": "#/components/schemas/is_subtask"
            },
            "priority": {
              "$ref": "#/components/schemas/priority"
            },
            "reminder": {
              "$ref": "#/components/schemas/reminder"
            },
            "task_description": {
              "$ref": "#/components/schemas/task_description"
            },
            "is_accountant_task": {
              "$ref": "#/components/schemas/is_accountant_task"
            },
            "task_number": {
              "$ref": "#/components/schemas/task_number"
            },
            "task_number_prefix": {
              "$ref": "#/components/schemas/task_number_prefix"
            },
            "task_number_suffix": {
              "$ref": "#/components/schemas/task_number_suffix"
            },
            "can_push": {
              "$ref": "#/components/schemas/can_push"
            },
            "created_by_id": {
              "$ref": "#/components/schemas/created_by_id"
            },
            "last_modified_by_id": {
              "$ref": "#/components/schemas/last_modified_by_id"
            },
            "template_id": {
              "$ref": "#/components/schemas/template_id"
            },
            "due_after": {
              "$ref": "#/components/schemas/due_after"
            },
            "parent_task_name": {
              "$ref": "#/components/schemas/parent_task_name"
            },
            "parent_task_number": {
              "$ref": "#/components/schemas/parent_task_number"
            },
            "created_by_name": {
              "$ref": "#/components/schemas/created_by_name"
            },
            "documents": {
              "$ref": "#/components/schemas/documents"
            },
            "custom_fields": {
              "$ref": "#/components/schemas/custom_fields"
            },
            "statuses": {
              "$ref": "#/components/schemas/statuses"
            },
            "is_system_task": {
              "$ref": "#/components/schemas/is_system_task"
            },
            "system_task_type": {
              "$ref": "#/components/schemas/system_task_type"
            },
            "comments": {
              "$ref": "#/components/schemas/comments"
            },
            "dependencies": {
              "$ref": "#/components/schemas/dependencies"
            },
            "entity_tags": {
              "$ref": "#/components/schemas/entity_tags"
            }
          }
        }
      }
    },
    "list-tasks-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "success",
          "readOnly": true
        },
        "tasks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "task_id": {
                "$ref": "#/components/schemas/task_id"
              },
              "task_number": {
                "$ref": "#/components/schemas/task_number"
              },
              "owner_id": {
                "$ref": "#/components/schemas/owner_id"
              },
              "owner_name": {
                "$ref": "#/components/schemas/owner_name"
              },
              "contact_id": {
                "$ref": "#/components/schemas/contact_id"
              },
              "billing_type": {
                "$ref": "#/components/schemas/billing_type"
              },
              "is_billable": {
                "$ref": "#/components/schemas/is_billable"
              },
              "task_rate": {
                "$ref": "#/components/schemas/task_rate"
              },
              "completion_percentage": {
                "$ref": "#/components/schemas/completion_percentage"
              },
              "contact_name": {
                "$ref": "#/components/schemas/contact_name"
              },
              "contact_type": {
                "$ref": "#/components/schemas/contact_type"
              },
              "client_id": {
                "$ref": "#/components/schemas/client_id"
              },
              "client_name": {
                "$ref": "#/components/schemas/client_name"
              },
              "title": {
                "$ref": "#/components/schemas/title"
              },
              "created_time": {
                "$ref": "#/components/schemas/created_time"
              },
              "created_time_formatted": {
                "$ref": "#/components/schemas/created_time_formatted"
              },
              "due_date": {
                "$ref": "#/components/schemas/due_date"
              },
              "is_accountant_task": {
                "$ref": "#/components/schemas/is_accountant_task"
              },
              "is_overdue": {
                "$ref": "#/components/schemas/is_overdue"
              },
              "parent_task_id": {
                "$ref": "#/components/schemas/parent_task_id"
              },
              "parent_status": {
                "$ref": "#/components/schemas/parent_status"
              },
              "priority": {
                "$ref": "#/components/schemas/priority"
              },
              "status": {
                "$ref": "#/components/schemas/status"
              },
              "color_code": {
                "$ref": "#/components/schemas/color_code"
              },
              "task_description": {
                "$ref": "#/components/schemas/task_description"
              },
              "subtask_count": {
                "$ref": "#/components/schemas/subtask_count"
              },
              "is_subtask": {
                "$ref": "#/components/schemas/is_subtask"
              },
              "parent_task_name": {
                "$ref": "#/components/schemas/parent_task_name"
              },
              "parent_task_number": {
                "$ref": "#/components/schemas/parent_task_number"
              },
              "custom_fields": {
                "$ref": "#/components/schemas/custom_fields"
              },
              "owners": {
                "$ref": "#/components/schemas/owners"
              },
              "entity_tags": {
                "$ref": "#/components/schemas/entity_tags"
              }
            }
          }
        }
      }
    },
    "update-tasks-request": {
      "type": "array",
      "description": "List of tasks to be updated.",
      "items": {
        "type": "object",
        "properties": {
          "task_id": {
            "$ref": "#/components/schemas/task_id"
          },
          "owner_ids": {
            "$ref": "#/components/schemas/owner_ids"
          },
          "owner_id": {
            "$ref": "#/components/schemas/owner_id"
          },
          "task_type": {
            "$ref": "#/components/schemas/task_type"
          },
          "title": {
            "$ref": "#/components/schemas/title"
          },
          "due_date": {
            "$ref": "#/components/schemas/due_date"
          },
          "contact_type": {
            "$ref": "#/components/schemas/contact_type"
          },
          "contact_id": {
            "$ref": "#/components/schemas/contact_id"
          },
          "can_push": {
            "$ref": "#/components/schemas/can_push"
          },
          "related_entity_type": {
            "$ref": "#/components/schemas/related_entity_type"
          },
          "related_entity_id": {
            "$ref": "#/components/schemas/related_entity_id"
          },
          "related_sub_entity_type": {
            "$ref": "#/components/schemas/related_sub_entity_type"
          },
          "related_sub_entity_id": {
            "$ref": "#/components/schemas/related_sub_entity_id"
          },
          "status": {
            "$ref": "#/components/schemas/status"
          },
          "billing_type": {
            "$ref": "#/components/schemas/billing_type"
          },
          "is_billable": {
            "$ref": "#/components/schemas/is_billable"
          },
          "task_rate": {
            "$ref": "#/components/schemas/task_rate"
          },
          "completion_percentage": {
            "$ref": "#/components/schemas/completion_percentage"
          },
          "priority": {
            "$ref": "#/components/schemas/priority"
          },
          "send_email_notification": {
            "$ref": "#/components/schemas/send_email_notification"
          },
          "mail_id": {
            "$ref": "#/components/schemas/mail_id"
          },
          "email_account_type": {
            "$ref": "#/components/schemas/email_account_type"
          },
          "email_folder_id": {
            "$ref": "#/components/schemas/email_folder_id"
          },
          "email_account_id": {
            "$ref": "#/components/schemas/email_account_id"
          },
          "mail_attachments": {
            "$ref": "#/components/schemas/mail_attachments"
          },
          "reminder": {
            "$ref": "#/components/schemas/reminder"
          },
          "task_description": {
            "$ref": "#/components/schemas/task_description"
          },
          "custom_fields": {
            "type": "array",
            "description": "List of custom fields associated with the task",
            "items": {
              "type": "object",
              "properties": {
                "customfield_id": {
                  "description": "ID of the custom field.",
                  "type": "string",
                  "example": 982000000567114
                },
                "index": {
                  "description": "Index of the custom field.",
                  "type": "integer",
                  "example": 1
                },
                "label": {
                  "description": "Label of the custom field.",
                  "type": "string",
                  "example": "Custom Field Label"
                },
                "value": {
                  "description": "Value of the custom field.",
                  "type": "string",
                  "example": "Custom Field Value"
                },
                "value_formatted": {
                  "description": "Formatted value of the custom field.",
                  "type": "string",
                  "example": "Formatted Custom Field Value"
                },
                "api_name": {
                  "description": "Name of the custom field.",
                  "type": "string",
                  "example": "CustomFieldAPIName"
                }
              }
            }
          },
          "due_after": {
            "$ref": "#/components/schemas/due_after"
          },
          "template_id": {
            "$ref": "#/components/schemas/template_id"
          },
          "task_number": {
            "$ref": "#/components/schemas/task_number"
          },
          "task_number_prefix": {
            "$ref": "#/components/schemas/task_number_prefix"
          },
          "task_number_suffix": {
            "$ref": "#/components/schemas/task_number_suffix"
          },
          "recurring_task_id": {
            "$ref": "#/components/schemas/recurring_task_id"
          },
          "is_sub_task": {
            "$ref": "#/components/schemas/is_sub_task"
          },
          "parent_id": {
            "$ref": "#/components/schemas/parent_id"
          },
          "dependencies": {
            "$ref": "#/components/schemas/dependencies"
          },
          "entity_tags": {
            "description": "List of tags to be associated with the task.",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "description": "Name of the tag.",
                  "type": "string",
                  "example": "Important"
                },
                "color": {
                  "description": "Color code of the tag.",
                  "type": "string",
                  "example": "FFB6C1"
                }
              }
            }
          }
        }
      }
    },
    "update-tasks-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Task updated",
          "readOnly": true
        },
        "tasks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "task_id": {
                "$ref": "#/components/schemas/task_id"
              },
              "recurring_task_id": {
                "$ref": "#/components/schemas/recurring_task_id"
              },
              "owner_id": {
                "$ref": "#/components/schemas/owner_id"
              },
              "owner_ids": {
                "$ref": "#/components/schemas/owner_ids"
              },
              "owner_name": {
                "$ref": "#/components/schemas/owner_name"
              },
              "owners": {
                "$ref": "#/components/schemas/owners"
              },
              "title": {
                "$ref": "#/components/schemas/title"
              },
              "due_date": {
                "$ref": "#/components/schemas/due_date"
              },
              "due_date_formatted": {
                "$ref": "#/components/schemas/due_date_formatted"
              },
              "is_overdue": {
                "$ref": "#/components/schemas/is_overdue"
              },
              "contact_type": {
                "$ref": "#/components/schemas/contact_type"
              },
              "contact_id": {
                "$ref": "#/components/schemas/contact_id"
              },
              "color_code": {
                "$ref": "#/components/schemas/color_code"
              },
              "contact_name": {
                "$ref": "#/components/schemas/contact_name"
              },
              "parent_task_id": {
                "$ref": "#/components/schemas/parent_task_id"
              },
              "related_entity_id": {
                "$ref": "#/components/schemas/related_entity_id"
              },
              "related_entity_type": {
                "$ref": "#/components/schemas/related_entity_type"
              },
              "related_entity": {
                "$ref": "#/components/schemas/related_entity"
              },
              "related_entity_value": {
                "$ref": "#/components/schemas/related_entity_value"
              },
              "parent_status": {
                "$ref": "#/components/schemas/parent_status"
              },
              "status": {
                "$ref": "#/components/schemas/status"
              },
              "custom_status_id": {
                "$ref": "#/components/schemas/custom_status_id"
              },
              "billing_type": {
                "$ref": "#/components/schemas/billing_type"
              },
              "is_billable": {
                "$ref": "#/components/schemas/is_billable"
              },
              "task_rate": {
                "$ref": "#/components/schemas/task_rate"
              },
              "completion_percentage": {
                "$ref": "#/components/schemas/completion_percentage"
              },
              "is_subtask": {
                "$ref": "#/components/schemas/is_subtask"
              },
              "priority": {
                "$ref": "#/components/schemas/priority"
              },
              "reminder": {
                "$ref": "#/components/schemas/reminder"
              },
              "task_description": {
                "$ref": "#/components/schemas/task_description"
              },
              "is_accountant_task": {
                "$ref": "#/components/schemas/is_accountant_task"
              },
              "task_number": {
                "$ref": "#/components/schemas/task_number"
              },
              "task_number_prefix": {
                "$ref": "#/components/schemas/task_number_prefix"
              },
              "task_number_suffix": {
                "$ref": "#/components/schemas/task_number_suffix"
              },
              "can_push": {
                "$ref": "#/components/schemas/can_push"
              },
              "created_by_id": {
                "$ref": "#/components/schemas/created_by_id"
              },
              "last_modified_by_id": {
                "$ref": "#/components/schemas/last_modified_by_id"
              },
              "template_id": {
                "$ref": "#/components/schemas/template_id"
              },
              "due_after": {
                "$ref": "#/components/schemas/due_after"
              },
              "parent_task_name": {
                "$ref": "#/components/schemas/parent_task_name"
              },
              "parent_task_number": {
                "$ref": "#/components/schemas/parent_task_number"
              },
              "created_by_name": {
                "$ref": "#/components/schemas/created_by_name"
              },
              "documents": {
                "$ref": "#/components/schemas/documents"
              },
              "custom_fields": {
                "$ref": "#/components/schemas/custom_fields"
              },
              "statuses": {
                "$ref": "#/components/schemas/statuses"
              },
              "is_system_task": {
                "$ref": "#/components/schemas/is_system_task"
              },
              "system_task_type": {
                "$ref": "#/components/schemas/system_task_type"
              },
              "comments": {
                "$ref": "#/components/schemas/comments"
              },
              "dependencies": {
                "$ref": "#/components/schemas/dependencies"
              },
              "entity_tags": {
                "$ref": "#/components/schemas/entity_tags"
              }
            }
          }
        }
      }
    },
    "delete-tasks-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Task deleted",
          "readOnly": true
        }
      }
    },
    "get-a-task-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "success",
          "readOnly": true
        },
        "task": {
          "type": "object",
          "properties": {
            "task_id": {
              "$ref": "#/components/schemas/task_id"
            },
            "recurring_task_id": {
              "$ref": "#/components/schemas/recurring_task_id"
            },
            "owner_id": {
              "$ref": "#/components/schemas/owner_id"
            },
            "owner_ids": {
              "$ref": "#/components/schemas/owner_ids"
            },
            "owner_name": {
              "$ref": "#/components/schemas/owner_name"
            },
            "owners": {
              "$ref": "#/components/schemas/owners"
            },
            "title": {
              "$ref": "#/components/schemas/title"
            },
            "due_date": {
              "$ref": "#/components/schemas/due_date"
            },
            "due_date_formatted": {
              "$ref": "#/components/schemas/due_date_formatted"
            },
            "is_overdue": {
              "$ref": "#/components/schemas/is_overdue"
            },
            "contact_type": {
              "$ref": "#/components/schemas/contact_type"
            },
            "contact_id": {
              "$ref": "#/components/schemas/contact_id"
            },
            "color_code": {
              "$ref": "#/components/schemas/color_code"
            },
            "contact_name": {
              "$ref": "#/components/schemas/contact_name"
            },
            "parent_task_id": {
              "$ref": "#/components/schemas/parent_task_id"
            },
            "related_entity_id": {
              "$ref": "#/components/schemas/related_entity_id"
            },
            "related_entity_type": {
              "$ref": "#/components/schemas/related_entity_type"
            },
            "related_entity": {
              "$ref": "#/components/schemas/related_entity"
            },
            "related_entity_value": {
              "$ref": "#/components/schemas/related_entity_value"
            },
            "parent_status": {
              "$ref": "#/components/schemas/parent_status"
            },
            "status": {
              "$ref": "#/components/schemas/status"
            },
            "custom_status_id": {
              "$ref": "#/components/schemas/custom_status_id"
            },
            "billing_type": {
              "$ref": "#/components/schemas/billing_type"
            },
            "is_billable": {
              "$ref": "#/components/schemas/is_billable"
            },
            "task_rate": {
              "$ref": "#/components/schemas/task_rate"
            },
            "completion_percentage": {
              "$ref": "#/components/schemas/completion_percentage"
            },
            "is_subtask": {
              "$ref": "#/components/schemas/is_subtask"
            },
            "priority": {
              "$ref": "#/components/schemas/priority"
            },
            "reminder": {
              "$ref": "#/components/schemas/reminder"
            },
            "task_description": {
              "$ref": "#/components/schemas/task_description"
            },
            "is_accountant_task": {
              "$ref": "#/components/schemas/is_accountant_task"
            },
            "task_number": {
              "$ref": "#/components/schemas/task_number"
            },
            "task_number_prefix": {
              "$ref": "#/components/schemas/task_number_prefix"
            },
            "task_number_suffix": {
              "$ref": "#/components/schemas/task_number_suffix"
            },
            "can_push": {
              "$ref": "#/components/schemas/can_push"
            },
            "created_by_id": {
              "$ref": "#/components/schemas/created_by_id"
            },
            "last_modified_by_id": {
              "$ref": "#/components/schemas/last_modified_by_id"
            },
            "template_id": {
              "$ref": "#/components/schemas/template_id"
            },
            "due_after": {
              "$ref": "#/components/schemas/due_after"
            },
            "parent_task_name": {
              "$ref": "#/components/schemas/parent_task_name"
            },
            "parent_task_number": {
              "$ref": "#/components/schemas/parent_task_number"
            },
            "created_by_name": {
              "$ref": "#/components/schemas/created_by_name"
            },
            "documents": {
              "$ref": "#/components/schemas/documents"
            },
            "custom_fields": {
              "$ref": "#/components/schemas/custom_fields"
            },
            "statuses": {
              "$ref": "#/components/schemas/statuses"
            },
            "is_system_task": {
              "$ref": "#/components/schemas/is_system_task"
            },
            "system_task_type": {
              "$ref": "#/components/schemas/system_task_type"
            },
            "comments": {
              "$ref": "#/components/schemas/comments"
            },
            "dependencies": {
              "$ref": "#/components/schemas/dependencies"
            },
            "entity_tags": {
              "$ref": "#/components/schemas/entity_tags"
            }
          }
        }
      }
    },
    "update-a-task-request": {
      "type": "object",
      "properties": {
        "task_id": {
          "$ref": "#/components/schemas/task_id"
        },
        "owner_ids": {
          "$ref": "#/components/schemas/owner_ids"
        },
        "owner_id": {
          "$ref": "#/components/schemas/owner_id"
        },
        "task_type": {
          "$ref": "#/components/schemas/task_type"
        },
        "title": {
          "$ref": "#/components/schemas/title"
        },
        "due_date": {
          "$ref": "#/components/schemas/due_date"
        },
        "contact_type": {
          "$ref": "#/components/schemas/contact_type"
        },
        "contact_id": {
          "$ref": "#/components/schemas/contact_id"
        },
        "can_push": {
          "$ref": "#/components/schemas/can_push"
        },
        "related_entity_type": {
          "$ref": "#/components/schemas/related_entity_type"
        },
        "related_entity_id": {
          "$ref": "#/components/schemas/related_entity_id"
        },
        "related_sub_entity_type": {
          "$ref": "#/components/schemas/related_sub_entity_type"
        },
        "related_sub_entity_id": {
          "$ref": "#/components/schemas/related_sub_entity_id"
        },
        "status": {
          "$ref": "#/components/schemas/status"
        },
        "billing_type": {
          "$ref": "#/components/schemas/billing_type"
        },
        "is_billable": {
          "$ref": "#/components/schemas/is_billable"
        },
        "task_rate": {
          "$ref": "#/components/schemas/task_rate"
        },
        "completion_percentage": {
          "$ref": "#/components/schemas/completion_percentage"
        },
        "priority": {
          "$ref": "#/components/schemas/priority"
        },
        "send_email_notification": {
          "$ref": "#/components/schemas/send_email_notification"
        },
        "mail_id": {
          "$ref": "#/components/schemas/mail_id"
        },
        "email_account_type": {
          "$ref": "#/components/schemas/email_account_type"
        },
        "email_folder_id": {
          "$ref": "#/components/schemas/email_folder_id"
        },
        "email_account_id": {
          "$ref": "#/components/schemas/email_account_id"
        },
        "mail_attachments": {
          "$ref": "#/components/schemas/mail_attachments"
        },
        "reminder": {
          "$ref": "#/components/schemas/reminder"
        },
        "task_description": {
          "$ref": "#/components/schemas/task_description"
        },
        "custom_fields": {
          "type": "array",
          "description": "List of custom fields associated with the task",
          "items": {
            "type": "object",
            "properties": {
              "customfield_id": {
                "description": "ID of the custom field.",
                "type": "string",
                "example": 982000000567114
              },
              "index": {
                "description": "Index of the custom field.",
                "type": "integer",
                "example": 1
              },
              "label": {
                "description": "Label of the custom field.",
                "type": "string",
                "example": "Custom Field Label"
              },
              "value": {
                "description": "Value of the custom field.",
                "type": "string",
                "example": "Custom Field Value"
              },
              "value_formatted": {
                "description": "Formatted value of the custom field.",
                "type": "string",
                "example": "Formatted Custom Field Value"
              },
              "api_name": {
                "description": "Name of the custom field.",
                "type": "string",
                "example": "CustomFieldAPIName"
              }
            }
          }
        },
        "due_after": {
          "$ref": "#/components/schemas/due_after"
        },
        "template_id": {
          "$ref": "#/components/schemas/template_id"
        },
        "task_number": {
          "$ref": "#/components/schemas/task_number"
        },
        "task_number_prefix": {
          "$ref": "#/components/schemas/task_number_prefix"
        },
        "task_number_suffix": {
          "$ref": "#/components/schemas/task_number_suffix"
        },
        "recurring_task_id": {
          "$ref": "#/components/schemas/recurring_task_id"
        },
        "is_sub_task": {
          "$ref": "#/components/schemas/is_sub_task"
        },
        "parent_id": {
          "$ref": "#/components/schemas/parent_id"
        },
        "dependencies": {
          "$ref": "#/components/schemas/dependencies"
        },
        "entity_tags": {
          "description": "List of tags to be associated with the task.",
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "description": "Name of the tag.",
                "type": "string",
                "example": "Important"
              },
              "color": {
                "description": "Color code of the tag.",
                "type": "string",
                "example": "FFB6C1"
              }
            }
          }
        }
      }
    },
    "update-a-task-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Task updated",
          "readOnly": true
        },
        "task": {
          "type": "object",
          "properties": {
            "task_id": {
              "$ref": "#/components/schemas/task_id"
            },
            "recurring_task_id": {
              "$ref": "#/components/schemas/recurring_task_id"
            },
            "owner_id": {
              "$ref": "#/components/schemas/owner_id"
            },
            "owner_ids": {
              "$ref": "#/components/schemas/owner_ids"
            },
            "owner_name": {
              "$ref": "#/components/schemas/owner_name"
            },
            "owners": {
              "$ref": "#/components/schemas/owners"
            },
            "title": {
              "$ref": "#/components/schemas/title"
            },
            "due_date": {
              "$ref": "#/components/schemas/due_date"
            },
            "due_date_formatted": {
              "$ref": "#/components/schemas/due_date_formatted"
            },
            "is_overdue": {
              "$ref": "#/components/schemas/is_overdue"
            },
            "contact_type": {
              "$ref": "#/components/schemas/contact_type"
            },
            "contact_id": {
              "$ref": "#/components/schemas/contact_id"
            },
            "color_code": {
              "$ref": "#/components/schemas/color_code"
            },
            "contact_name": {
              "$ref": "#/components/schemas/contact_name"
            },
            "parent_task_id": {
              "$ref": "#/components/schemas/parent_task_id"
            },
            "related_entity_id": {
              "$ref": "#/components/schemas/related_entity_id"
            },
            "related_entity_type": {
              "$ref": "#/components/schemas/related_entity_type"
            },
            "related_entity": {
              "$ref": "#/components/schemas/related_entity"
            },
            "related_entity_value": {
              "$ref": "#/components/schemas/related_entity_value"
            },
            "parent_status": {
              "$ref": "#/components/schemas/parent_status"
            },
            "status": {
              "$ref": "#/components/schemas/status"
            },
            "custom_status_id": {
              "$ref": "#/components/schemas/custom_status_id"
            },
            "billing_type": {
              "$ref": "#/components/schemas/billing_type"
            },
            "is_billable": {
              "$ref": "#/components/schemas/is_billable"
            },
            "task_rate": {
              "$ref": "#/components/schemas/task_rate"
            },
            "completion_percentage": {
              "$ref": "#/components/schemas/completion_percentage"
            },
            "is_subtask": {
              "$ref": "#/components/schemas/is_subtask"
            },
            "priority": {
              "$ref": "#/components/schemas/priority"
            },
            "reminder": {
              "$ref": "#/components/schemas/reminder"
            },
            "task_description": {
              "$ref": "#/components/schemas/task_description"
            },
            "is_accountant_task": {
              "$ref": "#/components/schemas/is_accountant_task"
            },
            "task_number": {
              "$ref": "#/components/schemas/task_number"
            },
            "task_number_prefix": {
              "$ref": "#/components/schemas/task_number_prefix"
            },
            "task_number_suffix": {
              "$ref": "#/components/schemas/task_number_suffix"
            },
            "can_push": {
              "$ref": "#/components/schemas/can_push"
            },
            "created_by_id": {
              "$ref": "#/components/schemas/created_by_id"
            },
            "last_modified_by_id": {
              "$ref": "#/components/schemas/last_modified_by_id"
            },
            "template_id": {
              "$ref": "#/components/schemas/template_id"
            },
            "due_after": {
              "$ref": "#/components/schemas/due_after"
            },
            "parent_task_name": {
              "$ref": "#/components/schemas/parent_task_name"
            },
            "parent_task_number": {
              "$ref": "#/components/schemas/parent_task_number"
            },
            "created_by_name": {
              "$ref": "#/components/schemas/created_by_name"
            },
            "documents": {
              "$ref": "#/components/schemas/documents"
            },
            "custom_fields": {
              "$ref": "#/components/schemas/custom_fields"
            },
            "statuses": {
              "$ref": "#/components/schemas/statuses"
            },
            "is_system_task": {
              "$ref": "#/components/schemas/is_system_task"
            },
            "system_task_type": {
              "$ref": "#/components/schemas/system_task_type"
            },
            "comments": {
              "$ref": "#/components/schemas/comments"
            },
            "dependencies": {
              "$ref": "#/components/schemas/dependencies"
            },
            "entity_tags": {
              "$ref": "#/components/schemas/entity_tags"
            }
          }
        }
      }
    },
    "delete-a-task-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Task deleted",
          "readOnly": true
        }
      }
    },
    "update-percentage-task-request": {
      "required": [
        "completion_percentage"
      ],
      "type": "object",
      "properties": {
        "completion_percentage": {
          "$ref": "#/components/schemas/completion_percentage"
        }
      }
    },
    "update-percentage-task-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Task percentage updated",
          "readOnly": true
        },
        "task": {
          "type": "object",
          "properties": {
            "task_id": {
              "$ref": "#/components/schemas/task_id"
            },
            "recurring_task_id": {
              "$ref": "#/components/schemas/recurring_task_id"
            },
            "owner_id": {
              "$ref": "#/components/schemas/owner_id"
            },
            "owner_ids": {
              "$ref": "#/components/schemas/owner_ids"
            },
            "owner_name": {
              "$ref": "#/components/schemas/owner_name"
            },
            "owners": {
              "$ref": "#/components/schemas/owners"
            },
            "title": {
              "$ref": "#/components/schemas/title"
            },
            "due_date": {
              "$ref": "#/components/schemas/due_date"
            },
            "due_date_formatted": {
              "$ref": "#/components/schemas/due_date_formatted"
            },
            "is_overdue": {
              "$ref": "#/components/schemas/is_overdue"
            },
            "contact_type": {
              "$ref": "#/components/schemas/contact_type"
            },
            "contact_id": {
              "$ref": "#/components/schemas/contact_id"
            },
            "color_code": {
              "$ref": "#/components/schemas/color_code"
            },
            "contact_name": {
              "$ref": "#/components/schemas/contact_name"
            },
            "parent_task_id": {
              "$ref": "#/components/schemas/parent_task_id"
            },
            "related_entity_id": {
              "$ref": "#/components/schemas/related_entity_id"
            },
            "related_entity_type": {
              "$ref": "#/components/schemas/related_entity_type"
            },
            "related_entity": {
              "$ref": "#/components/schemas/related_entity"
            },
            "related_entity_value": {
              "$ref": "#/components/schemas/related_entity_value"
            },
            "parent_status": {
              "$ref": "#/components/schemas/parent_status"
            },
            "status": {
              "$ref": "#/components/schemas/status"
            },
            "custom_status_id": {
              "$ref": "#/components/schemas/custom_status_id"
            },
            "billing_type": {
              "$ref": "#/components/schemas/billing_type"
            },
            "is_billable": {
              "$ref": "#/components/schemas/is_billable"
            },
            "task_rate": {
              "$ref": "#/components/schemas/task_rate"
            },
            "completion_percentage": {
              "$ref": "#/components/schemas/completion_percentage"
            },
            "is_subtask": {
              "$ref": "#/components/schemas/is_subtask"
            },
            "priority": {
              "$ref": "#/components/schemas/priority"
            },
            "reminder": {
              "$ref": "#/components/schemas/reminder"
            },
            "task_description": {
              "$ref": "#/components/schemas/task_description"
            },
            "is_accountant_task": {
              "$ref": "#/components/schemas/is_accountant_task"
            },
            "task_number": {
              "$ref": "#/components/schemas/task_number"
            },
            "task_number_prefix": {
              "$ref": "#/components/schemas/task_number_prefix"
            },
            "task_number_suffix": {
              "$ref": "#/components/schemas/task_number_suffix"
            },
            "can_push": {
              "$ref": "#/components/schemas/can_push"
            },
            "created_by_id": {
              "$ref": "#/components/schemas/created_by_id"
            },
            "last_modified_by_id": {
              "$ref": "#/components/schemas/last_modified_by_id"
            },
            "template_id": {
              "$ref": "#/components/schemas/template_id"
            },
            "due_after": {
              "$ref": "#/components/schemas/due_after"
            },
            "parent_task_name": {
              "$ref": "#/components/schemas/parent_task_name"
            },
            "parent_task_number": {
              "$ref": "#/components/schemas/parent_task_number"
            },
            "created_by_name": {
              "$ref": "#/components/schemas/created_by_name"
            },
            "documents": {
              "$ref": "#/components/schemas/documents"
            },
            "custom_fields": {
              "$ref": "#/components/schemas/custom_fields"
            },
            "statuses": {
              "$ref": "#/components/schemas/statuses"
            },
            "is_system_task": {
              "$ref": "#/components/schemas/is_system_task"
            },
            "system_task_type": {
              "$ref": "#/components/schemas/system_task_type"
            },
            "comments": {
              "$ref": "#/components/schemas/comments"
            },
            "dependencies": {
              "$ref": "#/components/schemas/dependencies"
            },
            "entity_tags": {
              "$ref": "#/components/schemas/entity_tags"
            }
          }
        }
      }
    },
    "mark-open-task-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Task status updated",
          "readOnly": true
        }
      }
    },
    "mark-ongoing-task-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Task status updated",
          "readOnly": true
        }
      }
    },
    "mark-completed-task-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Task status updated",
          "readOnly": true
        }
      }
    },
    "add-task-comment-request": {
      "required": [
        "description"
      ],
      "type": "object",
      "properties": {
        "description": {
          "description": "Description of the comment.",
          "type": "string",
          "example": "This is a sample comment."
        }
      }
    },
    "add-task-comment-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Comments added",
          "readOnly": true
        },
        "comment": {
          "$ref": "#/components/schemas/comment"
        }
      }
    },
    "list-task-comments-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "success",
          "readOnly": true
        },
        "comments": {
          "$ref": "#/components/schemas/comments"
        }
      }
    },
    "delete-task-comment-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Comments deleted",
          "readOnly": true
        }
      }
    },
    "add-task-attachment-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "File uploaded",
          "readOnly": true
        },
        "documents": {
          "$ref": "#/components/schemas/documents"
        }
      }
    },
    "get-a-task-document-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "success",
          "readOnly": true
        },
        "documents": {
          "$ref": "#/components/schemas/document"
        }
      }
    },
    "delete-task-document-response": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "example": 0,
          "readOnly": true
        },
        "message": {
          "type": "string",
          "example": "Attachment deleted",
          "readOnly": true
        }
      }
    }
  }
}