193 lines
40 KiB
JSON
193 lines
40 KiB
JSON
{
|
|
"name": "AddAsanaTask",
|
|
"fully_qualified_name": "AsanaApi.AddAsanaTask@0.1.0",
|
|
"description": "Create a new task in Asana.\n\nUse this tool to create a new task in a specified Asana workspace. You can set various fields on the task upon creation. It is required to specify a workspace, which cannot be changed later, unless specified through projects or a parent task.",
|
|
"toolkit": {
|
|
"name": "AsanaApi",
|
|
"description": null,
|
|
"version": "0.1.0"
|
|
},
|
|
"input": {
|
|
"parameters": [
|
|
{
|
|
"name": "task_details",
|
|
"required": true,
|
|
"description": "JSON object containing details of the task to create, including fields like name, notes, assignee, due date, etc.",
|
|
"value_schema": {
|
|
"val_type": "json",
|
|
"inner_val_type": null,
|
|
"enum": null,
|
|
"properties": {
|
|
"data": {
|
|
"val_type": "json",
|
|
"inner_val_type": null,
|
|
"enum": null,
|
|
"properties": null,
|
|
"inner_properties": null,
|
|
"description": null
|
|
}
|
|
},
|
|
"inner_properties": null,
|
|
"description": "The task to create."
|
|
},
|
|
"inferrable": true,
|
|
"http_endpoint_parameter_name": "requestBody"
|
|
},
|
|
{
|
|
"name": "include_optional_fields",
|
|
"required": false,
|
|
"description": "Comma-separated list of optional task properties to include in the response. Excludes some properties by default.",
|
|
"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": "enable_pretty_output",
|
|
"required": false,
|
|
"description": "Enable to receive the response in a readable format with line breaks and indentation. Use 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 'createTask'.",
|
|
"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": {
|
|
"scopes": [
|
|
"tasks:write"
|
|
]
|
|
}
|
|
},
|
|
"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/tasks",
|
|
"http_method": "POST",
|
|
"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_fields",
|
|
"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": "requestBody",
|
|
"tool_parameter_name": "task_details",
|
|
"description": "The task to create.",
|
|
"value_schema": {
|
|
"val_type": "json",
|
|
"inner_val_type": null,
|
|
"enum": null,
|
|
"properties": {
|
|
"data": {
|
|
"val_type": "json",
|
|
"inner_val_type": null,
|
|
"enum": null,
|
|
"properties": null,
|
|
"inner_properties": null,
|
|
"description": null
|
|
}
|
|
},
|
|
"inner_properties": null,
|
|
"description": "The task to create."
|
|
},
|
|
"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\": \"The task to create.\",\n \"required\": true,\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"data\": {\n \"allOf\": [\n {\n \"allOf\": [\n {\n \"description\": \"The *task* is the basic object around which many operations in Asana are centered.\",\n \"type\": \"object\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the resource, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\",\n \"x-insert-after\": false\n },\n \"resource_type\": {\n \"description\": \"The base type of this resource.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"task\",\n \"x-insert-after\": \"gid\"\n },\n \"name\": {\n \"description\": \"The name of the task.\",\n \"type\": \"string\",\n \"example\": \"Bug Task\"\n },\n \"resource_subtype\": {\n \"type\": \"string\",\n \"description\": \"The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning.\\nThe resource_subtype `milestone` represent a single moment in time. This means tasks with this subtype cannot have a start_date.\",\n \"enum\": [\n \"default_task\",\n \"milestone\",\n \"approval\"\n ],\n \"example\": \"default_task\"\n },\n \"created_by\": {\n \"type\": \"object\",\n \"readOnly\": true,\n \"description\": \"[Opt In](/docs/inputoutput-options). A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the resource.\",\n \"type\": \"string\",\n \"example\": \"1111\"\n },\n \"resource_type\": {\n \"description\": \"The type of resource.\",\n \"type\": \"string\",\n \"example\": \"user\"\n }\n }\n }\n }\n },\n {\n \"type\": \"object\",\n \"properties\": {\n \"approval_status\": {\n \"type\": \"string\",\n \"description\": \"*Conditional* Reflects the approval status of this task. This field is kept in sync with `completed`, meaning `pending` translates to false while `approved`, `rejected`, and `changes_requested` translate to true. If you set completed to true, this field will be set to `approved`.\",\n \"enum\": [\n \"pending\",\n \"approved\",\n \"rejected\",\n \"changes_requested\"\n ],\n \"example\": \"pending\"\n },\n \"assignee_status\": {\n \"description\": \"*Deprecated* Scheduling status of this task for the user it is assigned to. This field can only be set if the assignee is non-null. Setting this field to \\\"inbox\\\" or \\\"upcoming\\\" inserts it at the top of the section, while the other options will insert at the bottom.\",\n \"type\": \"string\",\n \"enum\": [\n \"today\",\n \"upcoming\",\n \"later\",\n \"new\",\n \"inbox\"\n ],\n \"example\": \"upcoming\"\n },\n \"completed\": {\n \"description\": \"True if the task is currently marked complete, false if not.\",\n \"type\": \"boolean\",\n \"example\": false\n },\n \"completed_at\": {\n \"description\": \"The time at which this task was completed, or null if the task is incomplete.\",\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"readOnly\": true,\n \"nullable\": true,\n \"example\": \"2012-02-22T02:06:58.147Z\"\n },\n \"completed_by\": {\n \"allOf\": [\n {\n \"description\": \"A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\",\n \"type\": \"object\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the resource, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\",\n \"x-insert-after\": false\n },\n \"resource_type\": {\n \"description\": \"The base type of this resource.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"user\",\n \"x-insert-after\": \"gid\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"*Read-only except when same user as requester*. The user's name.\",\n \"example\": \"Greg Sanchez\"\n }\n }\n },\n {\n \"readOnly\": true,\n \"nullable\": true\n }\n ]\n },\n \"created_at\": {\n \"description\": \"The time at which this resource was created.\",\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"readOnly\": true,\n \"example\": \"2012-02-22T02:06:58.147Z\"\n },\n \"dependencies\": {\n \"description\": \"[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that this task depends on. The objects contain only the gid of the dependency.\",\n \"type\": \"array\",\n \"items\": {\n \"description\": \"A generic Asana Resource, containing a globally unique identifier.\",\n \"type\": \"object\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the resource, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\",\n \"x-insert-after\": false\n },\n \"resource_type\": {\n \"description\": \"The base type of this resource.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"task\",\n \"x-insert-after\": \"gid\"\n }\n }\n },\n \"readOnly\": true\n },\n \"dependents\": {\n \"description\": \"[Opt In](/docs/inputoutput-options). Array of resources referencing tasks that depend on this task. The objects contain only the ID of the dependent.\",\n \"type\": \"array\",\n \"items\": {\n \"description\": \"A generic Asana Resource, containing a globally unique identifier.\",\n \"type\": \"object\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the resource, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\",\n \"x-insert-after\": false\n },\n \"resource_type\": {\n \"description\": \"The base type of this resource.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"task\",\n \"x-insert-after\": \"gid\"\n }\n }\n },\n \"readOnly\": true\n },\n \"due_at\": {\n \"description\": \"The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with `due_on`.\",\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"example\": \"2019-09-15T02:06:58.147Z\",\n \"nullable\": true\n },\n \"due_on\": {\n \"description\": \"The localized date on which this task is due, or null if the task has no due date. This takes a date with `YYYY-MM-DD` format and should not be used together with `due_at`.\",\n \"type\": \"string\",\n \"format\": \"date\",\n \"example\": \"2019-09-15\",\n \"nullable\": true\n },\n \"external\": {\n \"description\": \"*OAuth Required*. *Conditional*. This field is returned only if external values are set or included by using [Opt In] (/docs/inputoutput-options).\\nThe external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with Oauth to access or modify this data. Once an external gid is set, you can use the notation `external:custom_gid` to reference your object anywhere in the API where you may use the original object gid. See the page on Custom External Data for more details.\",\n \"type\": \"object\",\n \"properties\": {\n \"gid\": {\n \"type\": \"string\",\n \"example\": \"1234\"\n },\n \"data\": {\n \"type\": \"string\",\n \"example\": \"A blob of information.\"\n }\n },\n \"example\": {\n \"gid\": \"my_gid\",\n \"data\": \"A blob of information\"\n }\n },\n \"html_notes\": {\n \"description\": \"[Opt In](/docs/inputoutput-options). The notes of the text with formatting as HTML.\",\n \"type\": \"string\",\n \"example\": \"<body>Mittens <em>really</em> likes the stuff from Humboldt.</body>\"\n },\n \"hearted\": {\n \"description\": \"*Deprecated - please use liked instead* True if the task is hearted by the authorized user, false if not.\",\n \"type\": \"boolean\",\n \"example\": true,\n \"readOnly\": true\n },\n \"hearts\": {\n \"description\": \"*Deprecated - please use likes instead* Array of likes for users who have hearted this task.\",\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"description\": \"An object to represent a user's like.\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the object, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\"\n },\n \"user\": {\n \"description\": \"A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\",\n \"type\": \"object\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the resource, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\",\n \"x-insert-after\": false\n },\n \"resource_type\": {\n \"description\": \"The base type of this resource.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"user\",\n \"x-insert-after\": \"gid\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"*Read-only except when same user as requester*. The user's name.\",\n \"example\": \"Greg Sanchez\"\n }\n }\n }\n }\n },\n \"readOnly\": true\n },\n \"is_rendered_as_separator\": {\n \"description\": \"[Opt In](/docs/inputoutput-options). In some contexts tasks can be rendered as a visual separator; for instance, subtasks can appear similar to [sections](/reference/sections) without being true `section` objects. If a `task` object is rendered this way in any context it will have the property `is_rendered_as_separator` set to `true`. This parameter only applies to regular tasks with `resource_subtype` of `default_task`. Tasks with `resource_subtype` of `milestone`, `approval`, or custom task types will not have this property and cannot be rendered as separators.\",\n \"type\": \"boolean\",\n \"example\": false,\n \"readOnly\": true\n },\n \"liked\": {\n \"description\": \"True if the task is liked by the authorized user, false if not.\",\n \"type\": \"boolean\",\n \"example\": true\n },\n \"likes\": {\n \"description\": \"Array of likes for users who have liked this task.\",\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"description\": \"An object to represent a user's like.\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the object, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\"\n },\n \"user\": {\n \"description\": \"A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.\",\n \"type\": \"object\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the resource, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\",\n \"x-insert-after\": false\n },\n \"resource_type\": {\n \"description\": \"The base type of this resource.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"user\",\n \"x-insert-after\": \"gid\"\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"*Read-only except when same user as requester*. The user's name.\",\n \"example\": \"Greg Sanchez\"\n }\n }\n }\n }\n },\n \"readOnly\": true\n },\n \"memberships\": {\n \"description\": \"<p><strong style={{ color: \\\"#4573D2\\\" }}>Full object requires scope: </strong><code>projects:read</code>, <code>project_sections:read</code></p>\\n\\n*Create-only*. Array of projects this task is associated with and the section it is in. At task creation time, this array can be used to add the task to specific sections. After task creation, these associations can be modified using the `addProject` and `removeProject` endpoints. Note that over time, more types of memberships may be added to this property.\",\n \"type\": \"array\",\n \"readOnly\": true,\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"project\": {\n \"description\": \"A *project* represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.\",\n \"type\": \"object\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the resource, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\",\n \"x-insert-after\": false\n },\n \"resource_type\": {\n \"description\": \"The base type of this resource.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"project\",\n \"x-insert-after\": \"gid\"\n },\n \"name\": {\n \"description\": \"Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.\",\n \"type\": \"string\",\n \"example\": \"Stuff to buy\"\n }\n }\n },\n \"section\": {\n \"description\": \"A *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.\",\n \"type\": \"object\",\n \"properties\": {\n \"gid\": {\n \"description\": \"Globally unique identifier of the resource, as a string.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"12345\",\n \"x-insert-after\": false\n },\n \"resource_type\": {\n \"description\": \"The base type of this resource.\",\n \"type\": \"string\",\n \"readOnly\": true,\n \"example\": \"section\",\n \"x-insert-after\": \"gid\"\n },\n \"name\": {\n \"description\": \"The name of the section (i.e. the text displayed as the section header).\",\n \"type\": \"string\",\n \"example\": \"Next Actions\"\n }\n }\n }\n }\n }\n },\n \"modified_at\": {\n \"description\": \"The time at which this task was last modified.\\n\\nThe following conditions will change `modified_at`:\\n\\n- story is created on a task\\n- story is trashed on a task\\n- attachment is trashed on a task\\n- task is assigned or unassigned\\n- custom field value is changed\\n- the task itself is trashed\\n- Or if any of the following fields are updated:\\n - completed\\n - name\\n - due_date\\n - description\\n - attachments\\n - items\\n - schedule_status\\n\\nThe following conditions will _not_ change `modified_at`:\\n\\n- moving to a new container (project, portfolio, etc)\\n- comments being added to the task (but the stories they generate\\n _will_ affect `modified_at`)\",\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"readOnly\": true,\n \"example\": \"2012-02-22T02:06:58.147Z\"\n },\n \"name\": {\n \"description\": \"Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.\",\n \"type\": \"string\",\n \"example\": \"Buy catnip\"\n },\n \"notes\": {\n \"description\": \"Free-form textual information associated with the task (i.e. its description).\",\n \"type\": \"string\",\n \"example\": \"Mittens really likes the stuff from Humboldt.\"\n },\n \"num_hearts\": {\n \"description\": \"*Deprecated - please use likes instead* The number of users who have hearted this task.\",\n \"type\": \"integer\",\n \"example\": 5,\n \"readOnly\": true\n },\n \"num_likes\": {\n \"description\": \"The number of users who have liked this task.\",\n \"type\": \"integer\",\n \"example\": 5,\n \"readOnly\": true\n },\n \"num_subtasks\": {\n \"description\": \"[Opt In](/docs/inputoutput-options). The number of subtasks on this task.\\n\",\n \"type\": \"integer\",\n \"example\": 3,\n \"readOnly\": true\n },\n \"start_at\": {\n \"description\": \"Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with `start_on`.\\n*Note: `due_at` must be present in the request when setting or unsetting the `start_at` parameter.*\",\n \"type\": \"string\",\n \"nullable\": true,\n \"format\": \"date-time\",\n \"example\": \"2019-09-14T02:06:58.147Z\"\n },\n \"start_on\": {\n \"description\": \"The day on which work begins for the task , or null if the task has no start date. This takes a date with `YYYY-MM-DD` format and should not be used together with `start_at`.\\n*Note: `due_on` or `due_at` must be present in the request when setting or unsetting the `start_on` parameter.*\",\n \"type\": \"string\",\n \"nullable\": true,\n \"format\": \"date\",\n \"example\": \"2019-09-14\"\n },\n \"actual_time_minutes\": {\n \"description\": \"<p><strong style={{ color: \\\"#4573D2\\\" }}>Full object requires scope: </strong><code>time_tracking_entries:read</code></p>\\n\\nThis value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value.\",\n \"type\": \"number\",\n \"example\": 200,\n \"readOnly\": true,\n \"nullable\": true\n }\n }\n }\n ]\n },\n {\n \"type\": \"object\",\n \"properties\": {\n \"assignee\": {\n \"type\": \"string\",\n \"readOnly\": false,\n \"x-env-variable\": true,\n \"description\": \"Gid of a user.\",\n \"example\": \"12345\",\n \"nullable\": true\n },\n \"assignee_section\": {\n \"nullable\": true,\n \"type\": \"string\",\n \"description\": \"The *assignee section* is a subdivision of a project that groups tasks together in the assignee's \\\"My tasks\\\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \\\"My tasks.\\\"\\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \\\"My tasks\\\" list.\",\n \"example\": \"12345\"\n },\n \"custom_fields\": {\n \"description\": \"An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, object, or array (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.\",\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\",\n \"description\": \"\\\"{custom_field_gid}\\\" => Value (can be text, a number, etc.). For date, use format \\\"YYYY-MM-DD\\\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z).\"\n },\n \"example\": {\n \"5678904321\": \"On Hold\",\n \"4578152156\": \"Not Started\"\n }\n },\n \"followers\": {\n \"type\": \"array\",\n \"description\": \"*Create-Only* An array of strings identifying users. These can either be the string \\\"me\\\", an email, or the gid of a user. In order to change followers on an existing task use `addFollowers` and `removeFollowers`.\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Gid of a user.\"\n },\n \"example\": [\n \"12345\"\n ]\n },\n \"parent\": {\n \"type\": \"string\",\n \"readOnly\": false,\n \"x-env-variable\": true,\n \"description\": \"Gid of a task.\",\n \"example\": \"12345\",\n \"nullable\": true\n },\n \"projects\": {\n \"type\": \"array\",\n \"description\": \"*Create-Only* Array of project gids. In order to change projects on an existing task use `addProject` and `removeProject`.\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Gid of a project.\"\n },\n \"example\": [\n \"12345\"\n ]\n },\n \"tags\": {\n \"type\": \"array\",\n \"description\": \"*Create-Only* Array of tag gids. In order to change tags on an existing task use `addTag` and `removeTag`.\",\n \"items\": {\n \"type\": \"string\",\n \"description\": \"Gid of a tag.\"\n },\n \"example\": [\n \"12345\"\n ]\n },\n \"workspace\": {\n \"type\": \"string\",\n \"readOnly\": false,\n \"x-env-variable\": true,\n \"description\": \"Gid of a workspace.\",\n \"example\": \"12345\"\n },\n \"custom_type\": {\n \"type\": \"string\",\n \"readOnly\": false,\n \"x-env-variable\": true,\n \"description\": \"GID or globally-unique identifier of a custom_type.\",\n \"example\": \"12345\",\n \"nullable\": true\n },\n \"custom_type_status_option\": {\n \"type\": \"string\",\n \"readOnly\": false,\n \"x-env-variable\": true,\n \"description\": \"GID or globally-unique identifier of a custom_type_status_option\",\n \"example\": \"12345\",\n \"nullable\": true\n }\n }\n }\n ]\n }\n }\n }\n }\n }\n}",
|
|
"use_request_body_schema_mode": true,
|
|
"validate_request_body_schema": true
|
|
}
|
|
}
|