InstantiateProjectFromTemplate
AsanaApi.InstantiateProjectFromTemplate
Description
Asynchronously instantiate a project from a template.
This tool creates a job to asynchronously handle project instantiation using a specified project template. It should be called when you need to create a new project from an existing template in Asana. Ensure you have the 'projects:write' scope and verify if your workspace is an organization.
Note: Understanding the request schema is necessary to properly create
the stringified JSON input object for execution.
This operation also requires path, query parameters.
Modes:
- GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't
already have it. Do NOT call repeatedly if you already received
the schema.
- EXECUTE: Performs the operation with the provided request body
JSON.
Note: You must also provide the required path, query parameters when executing.
If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Input Parameters
{
"parameters": [
{
"name": "mode",
"required": true,
"inferrable": true,
"description": "Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation",
"value_schema": {
"enum": [
"get_request_schema",
"execute"
],
"val_type": "string"
}
},
{
"name": "project_template_id",
"required": false,
"inferrable": true,
"description": "Globally unique identifier for the project template to instantiate the project from. Required when mode is 'execute', ignored when mode is 'get_request_schema'.",
"value_schema": {
"val_type": "string"
}
},
{
"name": "include_optional_properties",
"required": false,
"inferrable": true,
"description": "A list of optional properties to include in the response. Provide as a comma-separated list. Only used when mode is 'execute'.",
"value_schema": {
"val_type": "array",
"inner_val_type": "string"
}
},
{
"name": "enable_pretty_output",
"required": false,
"inferrable": true,
"description": "Enable pretty formatting for the response. Use this for debugging purposes as it increases response time and size. Only used when mode is 'execute'.",
"value_schema": {
"val_type": "boolean"
}
},
{
"name": "request_body",
"required": false,
"inferrable": true,
"description": "Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'",
"value_schema": {
"val_type": "string"
}
}
]
}Output
{
"description": "Response from the API endpoint 'instantiateProject'.",
"value_schema": {
"val_type": "json"
},
"available_modes": [
"value",
"error"
]
}