arcade-mcp/toolkits/asana_api/arcade_asana_api/wrapper_tools/UpdateProjectBriefAsana.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

222 lines
11 KiB
JSON

{
"name": "UpdateProjectBriefAsana",
"fully_qualified_name": "AsanaApi.UpdateProjectBriefAsana@0.1.0",
"description": "Update an Asana project brief.\n\nUse this tool to update an existing Asana project brief. Specify only the fields to be updated; fields not specified will remain unchanged. Returns the complete updated project brief record.",
"toolkit": {
"name": "AsanaApi",
"description": null,
"version": "0.1.0"
},
"input": {
"parameters": [
{
"name": "project_brief_id",
"required": true,
"description": "Globally unique identifier for the specific project brief to update.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Globally unique identifier for the project brief."
},
"inferrable": true,
"http_endpoint_parameter_name": "project_brief_gid"
},
{
"name": "updated_project_brief_fields",
"required": true,
"description": "The fields to update in the project brief, formatted as a JSON object.",
"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 updated fields for the project brief."
},
"inferrable": true,
"http_endpoint_parameter_name": "requestBody"
},
{
"name": "include_optional_properties",
"required": false,
"description": "Specify a list of properties to include in the response, separated by commas.",
"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": "provide_pretty_output",
"required": false,
"description": "If true, the response is formatted with line breaks and indentation for readability. Use primarily for 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."
},
"inferrable": true,
"http_endpoint_parameter_name": "opt_pretty"
}
]
},
"output": {
"description": "Response from the API endpoint 'updateProjectBrief'.",
"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/project_briefs/{project_brief_gid}",
"http_method": "PUT",
"headers": {},
"parameters": [
{
"name": "opt_pretty",
"tool_parameter_name": "provide_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": "project_brief_gid",
"tool_parameter_name": "project_brief_id",
"description": "Globally unique identifier for the project brief.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Globally unique identifier for the project brief."
},
"accepted_as": "path",
"required": true,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "requestBody",
"tool_parameter_name": "updated_project_brief_fields",
"description": "The updated fields for the project brief.",
"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 updated fields for the project brief."
},
"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 updated fields for the project brief.\",\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\": \"A *Project Brief* allows you to explain the what and why of the project to your team.\",\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_brief\",\n \"x-insert-after\": \"gid\"\n }\n }\n },\n {\n \"type\": \"object\",\n \"properties\": {\n \"title\": {\n \"description\": \"The title of the project brief.\",\n \"type\": \"string\",\n \"example\": \"Stuff to buy \\u2014 Project Brief\"\n },\n \"html_text\": {\n \"description\": \"HTML formatted text for the project brief.\",\n \"type\": \"string\",\n \"example\": \"<body>This is a <strong>project brief</strong>.</body>\"\n }\n }\n }\n ]\n },\n {\n \"type\": \"object\",\n \"properties\": {\n \"text\": {\n \"description\": \"The plain text of the project brief. When writing to a project brief, you can specify either `html_text` (preferred) or `text`, but not both.\",\n \"type\": \"string\",\n \"example\": \"This is a project brief.\"\n }\n }\n }\n ]\n }\n }\n }\n }\n }\n}",
"use_request_body_schema_mode": true,
"validate_request_body_schema": true
}
}