{ "name": "UpdateTimeTrackingEntry", "fully_qualified_name": "AsanaApi.UpdateTimeTrackingEntry@0.1.0", "description": "Updates an existing time tracking entry in Asana.\n\nUse this tool to update specific fields of an existing time tracking entry in Asana by specifying only the fields you wish to change. It helps avoid overwriting changes made by others and returns the updated record.", "toolkit": { "name": "AsanaApi", "description": null, "version": "0.1.0" }, "input": { "parameters": [ { "name": "time_tracking_entry_id", "required": true, "description": "Globally unique identifier for the time tracking entry to be updated.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Globally unique identifier for the time tracking entry." }, "inferrable": true, "http_endpoint_parameter_name": "time_tracking_entry_gid" }, { "name": "include_optional_properties", "required": false, "description": "Comma-separated list of optional properties to include in the response.", "value_schema": { "val_type": "array", "inner_val_type": "string", "enum": null, "properties": null, "inner_properties": null, "description": "This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include." }, "inferrable": true, "http_endpoint_parameter_name": "opt_fields" }, { "name": "duration_minutes_tracked", "required": false, "description": "The time in minutes tracked by the entry. Optional field.", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "*Optional*. Time in minutes tracked by the entry" }, "inferrable": true, "http_endpoint_parameter_name": "data.duration_minutes" }, { "name": "entry_logged_date", "required": false, "description": "The date the entry is logged. Defaults to today if not specified. Use format 'YYYY-MM-DD'.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "*Optional*. The day that this entry is logged on. Defaults to today if no day specified" }, "inferrable": true, "http_endpoint_parameter_name": "data.entered_on" }, { "name": "project_attributable_gid", "required": false, "description": "Optional. The globally unique identifier (gid) of the project to which the time is attributable.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "*Optional*. The gid of the project which the time is attributable to." }, "inferrable": true, "http_endpoint_parameter_name": "data.attributable_to" }, { "name": "enable_pretty_output", "required": false, "description": "Enable formatted output for easier readability. Use mainly for debugging as it increases response time and size.", "value_schema": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Provides \u201cpretty\u201d output.\nProvides the response in a \u201cpretty\u201d format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging." }, "inferrable": true, "http_endpoint_parameter_name": "opt_pretty" } ] }, "output": { "description": "Response from the API endpoint 'updateTimeTrackingEntry'.", "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-asana", "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 asana API." }, "http_endpoint": { "metadata": { "object_type": "http_endpoint", "version": "1.2.0", "description": "" }, "url": "https://app.asana.com/api/1.0/time_tracking_entries/{time_tracking_entry_gid}", "http_method": "PUT", "headers": {}, "parameters": [ { "name": "opt_pretty", "tool_parameter_name": "enable_pretty_output", "description": "Provides \u201cpretty\u201d output.\nProvides the response in a \u201cpretty\u201d format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.", "value_schema": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Provides \u201cpretty\u201d output.\nProvides the response in a \u201cpretty\u201d format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging." }, "accepted_as": "query", "required": false, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "opt_fields", "tool_parameter_name": "include_optional_properties", "description": "This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.", "value_schema": { "val_type": "array", "inner_val_type": "string", "enum": null, "properties": null, "inner_properties": null, "description": "This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include." }, "accepted_as": "query", "required": false, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "time_tracking_entry_gid", "tool_parameter_name": "time_tracking_entry_id", "description": "Globally unique identifier for the time tracking entry.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Globally unique identifier for the time tracking entry." }, "accepted_as": "path", "required": true, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "data.duration_minutes", "tool_parameter_name": "duration_minutes_tracked", "description": "*Optional*. Time in minutes tracked by the entry", "value_schema": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "*Optional*. Time in minutes tracked by the entry" }, "accepted_as": "body", "required": false, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "data.entered_on", "tool_parameter_name": "entry_logged_date", "description": "*Optional*. The day that this entry is logged on. Defaults to today if no day specified", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "*Optional*. The day that this entry is logged on. Defaults to today if no day specified" }, "accepted_as": "body", "required": false, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "data.attributable_to", "tool_parameter_name": "project_attributable_gid", "description": "*Optional*. The gid of the project which the time is attributable to.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "*Optional*. The gid of the project which the time is attributable to." }, "accepted_as": "body", "required": false, "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\": \"The updated fields for the time tracking entry.\",\n \"required\": true,\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"data\": {\n \"type\": \"object\",\n \"properties\": {\n \"duration_minutes\": {\n \"description\": \"*Optional*. Time in minutes tracked by the entry\",\n \"type\": \"integer\",\n \"example\": 12\n },\n \"entered_on\": {\n \"description\": \"*Optional*. The day that this entry is logged on. Defaults to today if no day specified\",\n \"type\": \"string\",\n \"format\": \"date\",\n \"example\": \"2023-03-19\"\n },\n \"attributable_to\": {\n \"type\": \"string\",\n \"description\": \"*Optional*. The gid of the project which the time is attributable to.\",\n \"example\": \"987654\"\n }\n }\n }\n }\n }\n }\n }\n}", "use_request_body_schema_mode": false, "validate_request_body_schema": false } }