arcade-mcp/toolkits/asana_api/arcade_asana_api/wrapper_tools/AddFollowersToTask.json
jottakka de742ff4f1
[MOAR][Asana][Github] Adding GitHub and Asana starter toolkits (#663)
Co-authored-by: Francisco Liberal <francisco@arcade.dev>
2025-10-30 18:21:34 -03:00

208 lines
8.6 KiB
JSON

{
"name": "AddFollowersToTask",
"fully_qualified_name": "AsanaApi.AddFollowersToTask@0.1.0",
"description": "Adds followers to an Asana task.\n\nUse this tool to add one or more followers to a specific task in Asana. The request will return the updated task record, reflecting the changes.",
"toolkit": {
"name": "AsanaApi",
"description": null,
"version": "0.1.0"
},
"input": {
"parameters": [
{
"name": "task_gid",
"required": true,
"description": "The unique identifier of the task to add followers to. This is required to specify which task the followers should be added to.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "The task to operate on."
},
"inferrable": true,
"http_endpoint_parameter_name": "task_gid"
},
{
"name": "include_optional_properties",
"required": false,
"description": "Comma-separated list of optional task 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": "followers_identification",
"required": false,
"description": "An array of strings identifying users, which can be 'me', an email, or a user gid.",
"value_schema": {
"val_type": "array",
"inner_val_type": "string",
"enum": null,
"properties": null,
"inner_properties": null,
"description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user."
},
"inferrable": true,
"http_endpoint_parameter_name": "data.followers"
},
{
"name": "enable_pretty_output",
"required": false,
"description": "Enables pretty formatting for the response, adding line breaks and indentation. Useful for debugging but increases response 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 'addFollowersForTask'.",
"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/{task_gid}/addFollowers",
"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_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": "task_gid",
"tool_parameter_name": "task_gid",
"description": "The task to operate on.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "The task to operate on."
},
"accepted_as": "path",
"required": true,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "data.followers",
"tool_parameter_name": "followers_identification",
"description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user.",
"value_schema": {
"val_type": "array",
"inner_val_type": "string",
"enum": null,
"properties": null,
"inner_properties": null,
"description": "An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user."
},
"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 followers to add to the task.\",\n \"required\": true,\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"data\": {\n \"type\": \"object\",\n \"properties\": {\n \"followers\": {\n \"description\": \"An array of strings identifying users. These can either be the string \\\"me\\\", an email, or the gid of a user.\",\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n },\n \"example\": [\n \"13579\",\n \"321654\"\n ]\n }\n },\n \"required\": [\n \"followers\"\n ]\n }\n }\n }\n }\n }\n}",
"use_request_body_schema_mode": false,
"validate_request_body_schema": false
}
}