{ "name": "CreateTimeEntry", "fully_qualified_name": "ClickupApi.CreateTimeEntry@0.1.0", "description": "Create a new time entry for tracking work.\n\nUse this tool to log a new time entry for a specific team. If the duration is negative, it indicates that a timer is running for the user.", "toolkit": { "name": "ClickupApi", "description": null, "version": "0.1.0" }, "input": { "parameters": [ { "name": "team_id_numeric", "required": true, "description": "The numeric ID of the workspace. Required if referencing a task by custom task ID.", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Workspace ID" }, "inferrable": true, "http_endpoint_parameter_name": "team_Id" }, { "name": "time_entry_details", "required": true, "description": "JSON object providing details for the time entry, including 'description', 'start', 'stop', 'tags', 'billable', 'assignee', 'tid'.", "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "description": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "tags": { "val_type": "array", "inner_val_type": "json", "enum": null, "properties": null, "inner_properties": { "name": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "tag_fg": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "tag_bg": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "description": "Users on the Business Plan and above can include a time tracking label." }, "start": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "stop": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The `duration` parameter can be used instead of the `stop` parameter. " }, "end": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "billable": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "duration": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "When there are values for both `start` and `end`, `duration` is ignored. The `stop` parameter can be used instead of the `duration` parameter." }, "assignee": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Workspace owners and admins can include any user id. Workspace members can only include their own user id." }, "tid": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "inner_properties": null, "description": "Associate a time entry with a task using the `tid` parameter." }, "inferrable": true, "http_endpoint_parameter_name": "requestBody" }, { "name": "workspace_id", "required": false, "description": "Required if `custom_task_ids` is true. Provide the Workspace ID for the team.", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "When the `custom_task_ids` parameter is set to `true`, the Workspace ID must be provided using the `team_id` parameter.\n \\\nFor example: `custom_task_ids=true&team_id=123`." }, "inferrable": true, "http_endpoint_parameter_name": "team_id" }, { "name": "use_custom_task_ids", "required": false, "description": "Set to true to reference a task by its custom task id.", "value_schema": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "If you want to reference a task by it's custom task id, this value must be `true`." }, "inferrable": true, "http_endpoint_parameter_name": "custom_task_ids" } ] }, "output": { "description": "Response from the API endpoint 'Createatimeentry'.", "available_modes": [ "value", "error", "null" ], "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "requirements": { "authorization": { "provider_id": "arcade-clickup", "provider_type": "oauth2", "id": null, "oauth2": null }, "secrets": null, "metadata": null }, "deprecation_message": null, "metadata": { "object_type": "api_wrapper_tool", "version": "1.1.0", "description": "Tools that enable LLMs to interact directly with the clickup API." }, "http_endpoint": { "metadata": { "object_type": "http_endpoint", "version": "1.2.0", "description": "" }, "url": "https://api.clickup.com/api/v2/team/{team_Id}/time_entries", "http_method": "POST", "headers": {}, "parameters": [ { "name": "custom_task_ids", "tool_parameter_name": "use_custom_task_ids", "description": "If you want to reference a task by it's custom task id, this value must be `true`.", "value_schema": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "If you want to reference a task by it's custom task id, this value must be `true`." }, "accepted_as": "query", "required": false, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "team_id", "tool_parameter_name": "workspace_id", "description": "When the `custom_task_ids` parameter is set to `true`, the Workspace ID must be provided using the `team_id` parameter.\n \\\nFor example: `custom_task_ids=true&team_id=123`.", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "When the `custom_task_ids` parameter is set to `true`, the Workspace ID must be provided using the `team_id` parameter.\n \\\nFor example: `custom_task_ids=true&team_id=123`." }, "accepted_as": "query", "required": false, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "team_Id", "tool_parameter_name": "team_id_numeric", "description": "Workspace ID", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Workspace ID" }, "accepted_as": "path", "required": true, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "requestBody", "tool_parameter_name": "time_entry_details", "description": "Associate a time entry with a task using the `tid` parameter.", "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "description": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "tags": { "val_type": "array", "inner_val_type": "json", "enum": null, "properties": null, "inner_properties": { "name": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "tag_fg": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "tag_bg": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "description": "Users on the Business Plan and above can include a time tracking label." }, "start": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "stop": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The `duration` parameter can be used instead of the `stop` parameter. " }, "end": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "billable": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "duration": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "When there are values for both `start` and `end`, `duration` is ignored. The `stop` parameter can be used instead of the `duration` parameter." }, "assignee": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Workspace owners and admins can include any user id. Workspace members can only include their own user id." }, "tid": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "inner_properties": null, "description": "Associate a time entry with a task using the `tid` parameter." }, "accepted_as": "body", "required": true, "deprecated": false, "default": null, "documentation_urls": [] } ], "documentation_urls": [], "secrets": [ { "arcade_key": "auth_token", "parameter_name": "Authorization", "accepted_as": "header", "formatted_value": "Bearer {authorization}", "description": "The OAuth token to use for authentication.", "is_auth_token": true } ], "request_body_spec": "{\n \"description\": \"Associate a time entry with a task using the `tid` parameter.\",\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"title\": \"Createatimeentryrequest\",\n \"required\": [\n \"start\",\n \"duration\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"description\": {\n \"type\": \"string\"\n },\n \"tags\": {\n \"description\": \"Users on the Business Plan and above can include a time tracking label.\",\n \"type\": \"array\",\n \"items\": {\n \"title\": \"Tags6\",\n \"required\": [\n \"name\",\n \"tag_fg\",\n \"tag_bg\"\n ],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\n \"type\": \"string\"\n },\n \"tag_fg\": {\n \"type\": \"string\"\n },\n \"tag_bg\": {\n \"type\": \"string\"\n }\n },\n \"examples\": [\n {\n \"name\": \"Tag name\",\n \"tag_fg\": \"#000000\",\n \"tag_bg\": \"#000000\"\n }\n ]\n }\n },\n \"start\": {\n \"type\": \"integer\",\n \"contentEncoding\": \"int64\"\n },\n \"stop\": {\n \"type\": \"integer\",\n \"contentEncoding\": \"int64\",\n \"description\": \"The `duration` parameter can be used instead of the `stop` parameter. \"\n },\n \"end\": {\n \"type\": \"integer\",\n \"contentEncoding\": \"int64\"\n },\n \"billable\": {\n \"type\": \"boolean\"\n },\n \"duration\": {\n \"description\": \"When there are values for both `start` and `end`, `duration` is ignored. The `stop` parameter can be used instead of the `duration` parameter.\",\n \"type\": \"integer\",\n \"contentEncoding\": \"int32\"\n },\n \"assignee\": {\n \"description\": \"Workspace owners and admins can include any user id. Workspace members can only include their own user id.\",\n \"type\": \"integer\",\n \"contentEncoding\": \"int32\"\n },\n \"tid\": {\n \"type\": \"string\"\n }\n },\n \"examples\": [\n {\n \"description\": \"from api\",\n \"tags\": [\n {\n \"name\": \"name of tag\",\n \"tag_bg\": \"#BF55EC\",\n \"tag_fg\": \"#FFFFFF\"\n }\n ],\n \"start\": 1595282645000,\n \"end\": 1595282660000,\n \"billable\": true,\n \"duration\": 50000,\n \"assignee\": 1,\n \"tid\": \"task_id\"\n }\n ]\n },\n \"example\": {\n \"description\": \"from api\",\n \"tags\": [\n {\n \"name\": \"name of tag\",\n \"tag_bg\": \"#BF55EC\",\n \"tag_fg\": \"#FFFFFF\"\n }\n ],\n \"start\": 1595282645000,\n \"billable\": true,\n \"duration\": 50000,\n \"assignee\": 1,\n \"tid\": \"task_id\"\n }\n }\n },\n \"required\": true\n}", "use_request_body_schema_mode": true, "validate_request_body_schema": true } }