# Asana

Your Toolhouse AI Worker can connect to Asana using 153 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=asana).

## Tools (153)

### `Asana Add Followers To Project`

Integration name: **ASANA\_ADD\_FOLLOWERS\_TO\_PROJECT**

Tool to add followers to a project in Asana. Use this tool when you need to add one or more users as followers to a specific project. Followers will receive notifications when tasks are added to the project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                           | Description                                                                                                                                                                                                                                                                         |
| ------------- | ------- | :------: | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `followers`   | string  |     ✅    | `"521621,621373"`                 | A string identifying users. These can either be the string "me", an email, or the gid of a user. For multiple followers, use a comma-separated string.                                                                                                                              |
| `opt_fields`  | array   |          | `["followers","name","archived"]` | 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.                                                                         |
| `opt_pretty`  | boolean |          | —                                 | Provides "pretty" output. Provides the response in a "pretty" 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. |
| `project_gid` | string  |     ✅    | `"1331"`                          | Globally unique identifier for the project.                                                                                                                                                                                                                                         |

***

### `Asana Add Followers To Task`

Integration name: **ASANA\_ADD\_FOLLOWERS\_TO\_TASK**

Tool to add followers to a task in Asana. Use this tool when you need to add one or more users as followers to a specific task. This will notify them of updates to the task.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                    | Description                                                                                                                                                                                                                                                                         |
| ------------ | ------- | :------: | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `task_gid`   | string  |     ✅    | `"1202599807151278"`       | The globally unique identifier for the task.                                                                                                                                                                                                                                        |
| `followers`  | array   |     ✅    | `["12345","67890"]`        | An array of user GIDs to add as followers to the task. For example: \["12345", "67890"].                                                                                                                                                                                            |
| `opt_fields` | array   |          | `["followers","assignee"]` | 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. For example \["followers", "assignee"].                                 |
| `opt_pretty` | boolean |          | —                          | Provides “pretty” output. Provides the response in a “pretty” 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. |

***

### `Asana Add Item To Portfolio`

Integration name: **ASANA\_ADD\_ITEM\_TO\_PORTFOLIO**

Add a project (or other supported item) to an Asana portfolio using the native addItem endpoint. Use when a workflow needs to attach a newly created project to a portfolio without using ASANA\_SUBMIT\_PARALLEL\_REQUESTS.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example              | Description                                                                                                                                                                |
| --------------- | ------ | :------: | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `item`          | string |     ✅    | `"1202599807151278"` | The globally unique identifier (GID) of the item to add to the portfolio. Typically a project GID, but can be any supported portfolio item type. Must be a numeric string. |
| `insert_after`  | string |          | `"1202599807151278"` | GID of a portfolio item after which to insert the new item. Mutually exclusive with `insert_before`.                                                                       |
| `insert_before` | string |          | `"1202599807151278"` | GID of a portfolio item before which to insert the new item. Mutually exclusive with `insert_after`.                                                                       |
| `portfolio_gid` | string |     ✅    | `"1202599807151278"` | The globally unique identifier (GID) of the portfolio to add the item to. Must be a numeric string.                                                                        |

***

### `Asana Add Members To Project`

Integration name: **ASANA\_ADD\_MEMBERS\_TO\_PROJECT**

Tool to add users to a project in Asana. Use this tool when you need to add one or more users as members to a specific project. Members can view and contribute to the project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                         | Description                                                                                                                                                                                                                                                                         |
| ------------- | ------- | :------: | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `members`     | string  |     ✅    | `"521621,621373"`               | An array of strings identifying users. These can either be the string "me", an email, or the gid of a user. For example: "521621,621373" or "me,<user@example.com>".                                                                                                                |
| `opt_fields`  | array   |          | `["members","name","archived"]` | 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. For example: \["members", "name", "archived"].                          |
| `opt_pretty`  | boolean |          | —                               | Provides "pretty" output. Provides the response in a "pretty" 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. |
| `project_gid` | string  |     ✅    | `"1331"`                        | Globally unique identifier for the project.                                                                                                                                                                                                                                         |

***

### `Asana Add Project For Task`

Integration name: **ASANA\_ADD\_PROJECT\_FOR\_TASK**

Tool to add a project to a task in Asana. Use when you need to associate a task with a project. Optionally position the task within the project using insert\_before, insert\_after, or section parameters.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example              | Description                                                                                                                                                                                                                                                                                                                                  |
| --------------- | ------- | :------: | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `project`       | string  |     ✅    | `"1210474562469922"` | The globally unique identifier for the project to add to the task.                                                                                                                                                                                                                                                                           |
| `section`       | string  |          | `"987654"`           | A section in the project to insert the task into. The task will be inserted at the bottom of the section unless combined with `insert_before: null` (end of section) or `insert_after: null` (beginning of section). Can also be combined with non-null `insert_before` or `insert_after` to position relative to a task within the section. |
| `task_gid`      | string  |     ✅    | `"1213196740913610"` | The globally unique identifier for the task to add a project to.                                                                                                                                                                                                                                                                             |
| `opt_pretty`    | boolean |          | —                    | Provides 'pretty' output. Provides the response in a 'pretty' 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.                                                          |
| `insert_after`  | string  |          | `"124816"`           | A task in the project to insert the task after, or `null` to insert at the beginning of the list. When used with `section`, `null` will insert at the beginning of the specified section, otherwise the task must be in the specified section.                                                                                               |
| `insert_before` | string  |          | `"432134"`           | A task in the project to insert the task before, or `null` to insert at the end of the list. When used with `section`, `null` will insert at the end of the specified section, otherwise the task must be in the specified section.                                                                                                          |

***

### `Asana Add Supporting Relationship`

Integration name: **ASANA\_ADD\_SUPPORTING\_RELATIONSHIP**

Tool to add a supporting goal relationship to a goal. Use when you want to link a project, task, portfolio, or another goal as a supporting resource to a specific goal in Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example   | Description                                                                                                                                                                                                                             |
| ------------ | ------- | :------: | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`       | object  |     ✅    | —         | The request data for adding a supporting relationship.                                                                                                                                                                                  |
| `goal_gid`   | string  |     ✅    | `"98765"` | Globally unique identifier for the goal.                                                                                                                                                                                                |
| `opt_fields` | array   |          | —         | This endpoint returns a compact 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.                    |
| `opt_pretty` | boolean |          | —         | Provides “pretty” output. 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. |

***

### `Asana Add Tag To Task`

Integration name: **ASANA\_ADD\_TAG\_TO\_TASK**

Tool to add an existing tag to a task in Asana. Use when you need to add a tag for prioritization, routing, or automation workflows. Tags cannot be added via Update Task, so this dedicated endpoint is required.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example              | Description                                                                                                                                                                                                                                    |
| ------------ | ------- | :------: | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tag_gid`    | string  |     ✅    | `"1234567890"`       | The globally unique identifier for the tag to add. The tag must already exist in the workspace.                                                                                                                                                |
| `task_gid`   | string  |     ✅    | `"1202599807151278"` | The globally unique identifier for the task.                                                                                                                                                                                                   |
| `opt_fields` | string  |          | `"name,gid"`         | Comma-separated list of fields to include in the response. Limited utility for this endpoint as it returns an empty data block.                                                                                                                |
| `opt_pretty` | boolean |          | —                    | Provides 'pretty' output. Provides the response in a 'pretty' format with proper line breaking and indentation for readability. This will take extra time and increase the response size so it is advisable only to use this during debugging. |

***

### `Asana Add Task Dependencies`

Integration name: **ASANA\_ADD\_TASK\_DEPENDENCIES**

Tool to add dependency relationships to an Asana task. Use when you need to mark one or more tasks as prerequisites (dependencies) for another task, ensuring the dependency tasks must be completed first.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example                                 | Description                                                                                                                                                                                                                                        |
| -------------- | ------- | :------: | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `task_gid`     | string  |     ✅    | `"1202599807151278"`                    | The globally unique identifier for the task that will depend on other tasks.                                                                                                                                                                       |
| `opt_fields`   | string  |          | `"name,assignee,dependencies,due_on"`   | Comma-separated list of fields to include in the response. By default, the response returns a compact representation of the task. Use this to retrieve additional fields such as 'name', 'assignee', 'due\_on', 'dependencies', etc.               |
| `opt_pretty`   | boolean |          | —                                       | Provides 'pretty' output. Provides the response in a 'pretty' format with 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. |
| `dependencies` | array   |     ✅    | `["123456789012345","987654321098765"]` | An array of task GIDs that the target task depends on (i.e., these tasks must be completed before the target task can be started). Each GID should be a valid task identifier.                                                                     |

***

### `Asana Add Task To Section`

Integration name: **ASANA\_ADD\_TASK\_TO\_SECTION**

Adds an existing task to a section, optionally positioning it before or after another task in that section; if no position is specified, the task is added to the end.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example              | Description                                                                                                                                                     |
| --------------- | ------ | :------: | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `task_gid`      | string |     ✅    | `"1202599807151278"` | The GID of the existing task to add to the section. Must be a numeric string.                                                                                   |
| `section_gid`   | string |     ✅    | `"1202599807151278"` | The GID of the target section. Must be a section GID (not a project or task GID). Use GET\_SECTIONS\_IN\_PROJECT to retrieve valid section GIDs from a project. |
| `insert_after`  | string |          | `"1202599807151278"` | GID of a task in the section after which to insert the current task. Mutually exclusive with insert\_before.                                                    |
| `insert_before` | string |          | `"1202599807151278"` | GID of a task in the section before which to insert the current task. Mutually exclusive with insert\_after.                                                    |

***

### `Asana Add User To Team`

Integration name: **ASANA\_ADD\_USER\_TO\_TEAM**

Tool to add a user to a team in Asana. Use this when you need to add a user to a specific team by providing their user GID, email, or "me" for the current user.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                     | Description                                                                                                                                                                                                                                                                       |
| ------------ | ------- | :------: | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`       | string  |     ✅    | `"12345"`                                                   | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                                                                                                  |
| `team_gid`   | string  |     ✅    | `"159874"`                                                  | Globally unique identifier for the team.                                                                                                                                                                                                                                          |
| `opt_fields` | array   |          | `["is_admin","is_guest","is_limited_access","team","user"]` | 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.                                                                       |
| `opt_pretty` | boolean |          | —                                                           | Provides "pretty" output. Provides the response in a pretty 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. |

***

### `Asana Add User To Workspace`

Integration name: **ASANA\_ADD\_USER\_TO\_WORKSPACE**

Tool to add a user to a workspace or organization in Asana. Use this when you need to add a user to a specific workspace by providing their user GID, email, or "me" for the current user.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                    | Description                                                                                                                                                                                                                                                                       |
| --------------- | ------- | :------: | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`          | string  |     ✅    | `"12345"`                  | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                                                                                                  |
| `opt_fields`    | array   |          | `["email","name","photo"]` | 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.                                                                       |
| `opt_pretty`    | boolean |          | —                          | Provides "pretty" output. Provides the response in a pretty 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. |
| `workspace_gid` | string  |     ✅    | `"12345"`                  | Globally unique identifier for the workspace or organization.                                                                                                                                                                                                                     |

***

### `Asana Approve Access Request`

Integration name: **ASANA\_APPROVE\_ACCESS\_REQUEST**

Tool to approve an access request in Asana. Use when you need to grant access to a resource that requires approval workflow.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example               | Description                                                                                                                                                                                                                                  |
| -------------------- | ------- | :------: | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`         | string  |          | `"gid,resource_type"` | Comma-separated list of fields to include in the response.                                                                                                                                                                                   |
| `opt_pretty`         | boolean |          | —                     | Provides "pretty" output. Provides the response in a pretty format with proper line breaking and indentation for readability. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
| `access_request_gid` | string  |     ✅    | `"12345"`             | Globally unique identifier for the access request to approve.                                                                                                                                                                                |

***

### `Asana Create Access Request`

Integration name: **ASANA\_CREATE\_ACCESS\_REQUEST**

Tool to create an access request in Asana. Use when you need to request access to a project or portfolio that you don't currently have access to.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                         | Description                                                                                                                                    |
| --------- | ------ | :------: | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `target`  | string |     ✅    | `"1210474562469922"`                            | The globally unique identifier (gid) of the access requestable object that the user is requesting access to. Supports projects and portfolios. |
| `message` | string |          | `"I'm looking to request access to this item."` | The optional message to include with the access request. This can be used to provide context or additional information about the request.      |

***

### `Asana Create Allocation`

Integration name: **ASANA\_CREATE\_ALLOCATION**

Creates a new allocation. Use when you need to schedule or assign a specific amount of a user's time per week to a task or project within a defined period.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                                   | Description                                                                                                                                    |
| --------------- | ------ | :------: | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `notes`         | string |          | `"Allocation for Q3 feature development"` | Any additional notes related to the allocation.                                                                                                |
| `end_on`        | string |     ✅    | `"2024-08-22"`                            | The end date of the allocation. The format is YYYY-MM-DD.                                                                                      |
| `start_on`      | string |     ✅    | `"2024-08-15"`                            | The start date of the allocation. The format is YYYY-MM-DD.                                                                                    |
| `effort_type`   | string |     ✅    | `"hours"`                                 | The unit type for tracking effort on the allocation. Must be either 'hours' or 'percent'.                                                      |
| `project_gid`   | string |          | `"111222"`                                | The project GID for which this allocation is being made. If provided, the allocation will be linked to this project.                           |
| `assignee_gid`  | string |     ✅    | `"67890"`                                 | The ID of the user to whom the allocation is assigned. This can be the user's GID or the string 'me' to refer to the authenticated user.       |
| `effort_value`  | number |     ✅    | `2`                                       | The numeric effort value for the allocation. Represents hours per week if effort\_type is 'hours', or percentage if effort\_type is 'percent'. |
| `workspace_gid` | string |     ✅    | `"12345"`                                 | The ID of the workspace where the allocation will be created.                                                                                  |

***

### `Asana Create A Project`

Integration name: **ASANA\_CREATE\_A\_PROJECT**

Creates a new Asana project in the specified workspace. Requires a `workspace` GID, and additionally a `team` GID if the workspace is an organization.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                     | Description                                                                    |
| ------------ | ------- | :------: | --------------------------- | ------------------------------------------------------------------------------ |
| `data`       | object  |     ✅    | —                           | Data payload for the new project.                                              |
| `opt_fields` | array   |          | `["name","notes","due_on"]` | Array of optional properties to include in the response.                       |
| `opt_pretty` | boolean |          | —                           | True for human-readable JSON response (debugging only due to size/processing). |

***

### `Asana Create A Tag In A Workspace`

Integration name: **ASANA\_CREATE\_A\_TAG\_IN\_A\_WORKSPACE**

Creates a new tag, with properties like name and color defined in the request body, within a specific Asana workspace (using `workspace_gid`); this tag helps categorize tasks, is confined to the workspace, and is not automatically applied to tasks.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example          | Description                                                                                                                                            |
| --------------- | ------- | :------: | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `data`          | object  |     ✅    | —                | The properties for the tag creation, including name (required), color (optional), and notes (optional).                                                |
| `opt_fields`    | array   |          | `["name,color"]` | Comma-separated string of fields from `OptFieldsEnm0` (e.g., 'name', 'color') to include in the response; returns a compact representation by default. |
| `opt_pretty`    | boolean |          | —                | If true, pretty-prints the JSON response; useful for debugging but may increase response size.                                                         |
| `workspace_gid` | string  |     ✅    | —                | The globally unique identifier (GID) for the workspace or organization in which to create the tag.                                                     |

***

### `Asana Create A Task`

Integration name: **ASANA\_CREATE\_A\_TASK**

Creates a new Asana task; requires 'workspace', 'parent', or 'projects' for association, and 'followers', 'projects', 'tags' are set only at creation.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                            | Description                                                                                                                                                                                                                                                                                               |
| ------------ | ------- | :------: | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`       | object  |     ✅    | —                                  | Task details for creation.                                                                                                                                                                                                                                                                                |
| `opt_fields` | array   |          | `"name,assignee,due_on,completed"` | List of optional field names to include in the response. Common fields include: name, assignee, due\_on, completed, projects, memberships, memberships.section, memberships.section.name, etc. For section information, use memberships.section or memberships.section.name. Default is compact resource. |
| `opt_pretty` | boolean |          | `"true"`                           | Provides 'pretty' JSON output with line breaks/indentation. Useful for debugging; may increase response time/size.                                                                                                                                                                                        |

***

### `Asana Create Attachment For Object`

Integration name: **ASANA\_CREATE\_ATTACHMENT\_FOR\_OBJECT**

Tool to upload an attachment or link an external resource to a task, project, or project\_brief in Asana. Use when you need to attach a file or external URL to any Asana object.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                       | Description                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------ | ------- | :------: | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string  |          | `"https://docs.composio.dev"` | The URL of the external resource being attached. Required for attachments of type 'external'. Mutually exclusive with 'file'.                                                                                                                                                                                                                                                |
| `file`             | object  |          | —                             | Required for 'asana' attachments. This field should be provided when uploading a file. Mutually exclusive with 'url'.                                                                                                                                                                                                                                                        |
| `name`             | string  |          | `"Composio Documentation"`    | The name of the external resource being attached. Required for attachments of type 'external'. For file uploads, this is optional and will be derived from the file if not provided.                                                                                                                                                                                         |
| `parent`           | string  |     ✅    | `"1212826719445794"`          | Required identifier of the parent task, project, or project\_brief, as a string. This is the GID of the object to attach the file or URL to.                                                                                                                                                                                                                                 |
| `connect_to_app`   | boolean |          | —                             | Optional. Only relevant for external attachments with a parent task. A boolean indicating whether the current app should be connected with the attachment for the purposes of showing an app components widget. Requires the app to have been added to a project the parent task is in. This property can only be set if an OAuth token is used to authenticate the request. |
| `resource_subtype` | string  |          | `"external"`                  | The type of the attachment. Must be 'asana' for file uploads or 'external' for URL attachments. If not specified, a file attachment of type 'asana' will be assumed. Note that if the value is 'external', 'name' and 'url' must also be provided.                                                                                                                           |

***

### `Asana Create Attachment For Task`

Integration name: **ASANA\_CREATE\_ATTACHMENT\_FOR\_TASK**

Tool to upload an attachment to a task. Use when you need to attach a file to a specific task in Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------ | ------- | :------: | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `file`             | object  |     ✅    | —         | The file to upload.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `parent_gid`       | string  |     ✅    | `"12345"` | Globally unique identifier for the parent task or comment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `connect_to_app`   | boolean |          | `true`    | Whether to connect the attachment to the app. If true, the attachment will be displayed in the Asana UI as an app attachment. If false, the attachment will be displayed as a regular file attachment. Defaults to true.                                                                                                                                                                                                                                                                                                                                                                            |
| `resource_subtype` | string  |          | `"asana"` | The type of the attachment. Must be one of the given values. If not specified, a regular file attachment will be created. If 'asana' is specified, the attachment will be a link to another Asana task. If 'external' is specified, the attachment will be a link to an external resource. If 'gdrive' is specified, the attachment will be a link to a Google Drive file. If 'box' is specified, the attachment will be a link to a Box file. If 'dropbox' is specified, the attachment will be a link to a Dropbox file. If 'vimeo' is specified, the attachment will be a link to a Vimeo video. |

***

### `Asana Create Custom Field`

Integration name: **ASANA\_CREATE\_CUSTOM\_FIELD**

Tool to create a new custom field in a workspace. Use when you need to define a new field for tracking specific information within Asana tasks.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example          | Description                                                    |
| ------------ | ------- | :------: | ---------------- | -------------------------------------------------------------- |
| `data`       | object  |     ✅    | —                | The custom field object to create.                             |
| `opt_fields` | array   |          | `["gid","name"]` | Comma-separated list of properties to include in the response. |
| `opt_pretty` | boolean |          | `true`           | Provides “pretty” output.                                      |

***

### `Asana Create Enum Option For Custom Field`

Integration name: **ASANA\_CREATE\_ENUM\_OPTION\_FOR\_CUSTOM\_FIELD**

Tool to create a new enum option for a custom field in Asana. Use this when you need to add a new selectable option to an existing custom field.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example          | Description                                      |
| ------------------ | ------- | :------: | ---------------- | ------------------------------------------------ |
| `data`             | object  |     ✅    | —                | The enum option to create.                       |
| `opt_fields`       | array   |          | `["name","gid"]` | Defines fields to return.                        |
| `opt_pretty`       | boolean |          | —                | Provides “pretty” output.                        |
| `custom_field_gid` | string  |     ✅    | `"12345"`        | Globally unique identifier for the custom field. |

***

### `Asana Create Membership`

Integration name: **ASANA\_CREATE\_MEMBERSHIP**

Tool to create a membership by adding a user or team to a project, goal, or portfolio. Use when you need to grant access to an Asana resource.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example              | Description                                                                                                                                         |
| -------------- | ------- | :------: | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `role`         | string  |          | `"approver"`         | Role of the member in the parent resource. This is an optional parameter.                                                                           |
| `member`       | string  |     ✅    | `"1210124065021206"` | GID of the member (user or team) to add to the parent resource. Must be a numeric GID string (e.g., '1210124065021206').                            |
| `parent`       | string  |     ✅    | `"1210474562469922"` | GID of the parent resource (project, goal, or portfolio) to add the member to. Must be a numeric GID string (e.g., '1210474562469922').             |
| `opt_pretty`   | boolean |          | `true`               | Provides 'pretty' output with proper line breaking and indentation for debugging. May increase response size.                                       |
| `access_level` | string  |          | `"editor"`           | Access level for the member in the parent resource. Common values: 'admin', 'editor', 'commenter', 'viewer'. Defaults to 'editor' if not specified. |

***

### `Asana Create Project Brief`

Integration name: **ASANA\_CREATE\_PROJECT\_BRIEF**

Tool to create a project brief for a project. Use when you need to add a detailed explanation (what and why) to a project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                                             | Description                                                                                                                                                                                                                                                                                   |
| ------------- | ------- | :------: | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `html_text`   | string  |     ✅    | `"<body>This is the project brief content.</body>"` | Rich text content wrapped in HTML body tag. The content must be wrapped in a tag, e.g., 'Project brief content here'.                                                                                                                                                                         |
| `opt_fields`  | array   |          | —                                                   | 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. Available options: html\_text, permalink\_url, project, project.name, text, title |
| `opt_pretty`  | boolean |          | —                                                   | Provides 'pretty' output. 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.                                                       |
| `project_gid` | string  |     ✅    | `"1331"`                                            | Globally unique identifier for the project.                                                                                                                                                                                                                                                   |

***

### `Asana Create Project For Team`

Integration name: **ASANA\_CREATE\_PROJECT\_FOR\_TEAM**

Tool to create a project in a team. Use when you need to create a new project within a specific Asana team.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                     | Description                                                                                                                                            |
| ------------ | ------- | :------: | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `data`       | object  |     ✅    | —                                           | Project data payload containing the project details to create.                                                                                         |
| `team_gid`   | string  |     ✅    | `"1210124791807950"`                        | Globally unique identifier for the team. This is the team where the project will be created.                                                           |
| `opt_fields` | array   |          | `["name","notes","owner","workspace.name"]` | Array of optional field names to include in the response (e.g., 'name', 'notes', 'owner', 'workspace.name'). By default, some properties are excluded. |
| `opt_pretty` | boolean |          | `true`                                      | Provides 'pretty' output with proper line breaking and indentation for debugging. Note: increases response size and processing time.                   |

***

### `Asana Create Project For Workspace`

Integration name: **ASANA\_CREATE\_PROJECT\_FOR\_WORKSPACE**

Tool to create a project in a workspace. Use when you need to create a new project within a specific Asana workspace. Note: The team field is required when creating projects in workspaces.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                                 | Description                                                                                                                                                         |
| --------------- | ------- | :------: | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`          | object  |     ✅    | —                                                       | Project data payload containing the project details to create.                                                                                                      |
| `opt_fields`    | array   |          | `["name","notes","owner","team.name","workspace.name"]` | Array of optional field names to include in the response (e.g., 'name', 'notes', 'owner', 'team.name', 'workspace.name'). By default, some properties are excluded. |
| `opt_pretty`    | boolean |          | `true`                                                  | Provides 'pretty' output with proper line breaking and indentation for debugging. Note: increases response size and processing time.                                |
| `workspace_gid` | string  |     ✅    | `"1205766922013215"`                                    | Globally unique identifier for the workspace or organization where the project will be created.                                                                     |

***

### `Asana Create Project Status Update`

Integration name: **ASANA\_CREATE\_PROJECT\_STATUS\_UPDATE**

Tool to create a new status update on a project. Use when you need to communicate the current status, progress, or any blockers related to a specific project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                                                                                            | Description                                                                              |
| ------------- | ------ | :------: | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `text`        | string |     ✅    | `"<h1>Weekly Update</h1><p>We are on track to complete the deliverables by end of next week.</p>"` | The HTML content of the status update.                                                   |
| `color`       | string |     ✅    | `"GREEN"`                                                                                          | Color of the status update. Supported values: GREEN, YELLOW, RED, BLUE, COMPLETE.        |
| `title`       | string |     ✅    | `"Project Alpha Status - Week 5"`                                                                  | The title of the project status update.                                                  |
| `project_gid` | string |     ✅    | `"12345"`                                                                                          | Globally unique identifier for the project.                                              |
| `status_type` | string |     ✅    | `"on_track"`                                                                                       | The type of status. Must be one of: on\_track, at\_risk, off\_track, on\_hold, complete. |

***

### `Asana Create Section In Project`

Integration name: **ASANA\_CREATE\_SECTION\_IN\_PROJECT**

Creates a new SECTION (not a task) in a project. Sections are organizational containers within a project used to group and categorize tasks (e.g., 'To Do', 'In Progress', 'Done', 'Backlog'). The new section can be optionally positioned relative to an existing section in the same project. IMPORTANT: This action creates SECTIONS only. Do NOT use this action to create tasks. To create a task, use the ASANA\_CREATE\_A\_TASK action instead. Task-related fields like 'assignee', 'notes', 'due\_date', 'description' are NOT supported by this action.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example              | Description                                                                                                                                        |
| --------------- | ------ | :------: | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`          | string |     ✅    | `"To Do"`            | Name for the new section. This is a section name (e.g., 'To Do', 'In Progress'), NOT a task name.                                                  |
| `project_gid`   | string |     ✅    | `"1210473471812630"` | GID of the project where the section will be created. Must be a valid project GID.                                                                 |
| `insert_after`  | string |          | `"12345"`            | GID of an existing section to insert the new section after; if omitted (and `insert_before` is also omitted), the new section is added at the end. |
| `insert_before` | string |          | `"12345"`            | GID of an existing section to insert the new section before; if omitted, the new section is added at the end.                                      |

***

### `Asana Create Status For Object`

Integration name: **ASANA\_CREATE\_STATUS\_FOR\_OBJECT**

Tool to create a status update on a project, portfolio, or goal. Use when you need to communicate progress, blockers, or current state to all followers of an object.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                                                    | Description                                                                                                                                                                                                  |
| ------------- | ------- | :------: | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `text`        | string  |     ✅    | `"Project is progressing well. All milestones on track."`  | The text content of the status update. This is the body of the status update that will be sent to all followers of the parent object.                                                                        |
| `title`       | string  |          | `"Weekly Status Update"`                                   | The title of the status update. If not provided, Asana may auto-generate a title based on the status\_type.                                                                                                  |
| `parent`      | string  |     ✅    | `"1210124791807961"`                                       | Globally unique identifier (GID) of the object to create a status update on. Can be a project, portfolio, or goal GID. GIDs are long numeric strings (e.g., '1210124791807961').                             |
| `opt_fields`  | array   |          | `["gid","title","status_type","created_at","author.name"]` | List of optional field names to include in the response. Common fields include: gid, title, text, status\_type, created\_at, created\_by, author, parent, resource\_subtype, html\_text, etc.                |
| `opt_pretty`  | boolean |          | `true`                                                     | Provides 'pretty' JSON output with line breaks and indentation. Useful for debugging; may increase response time and size.                                                                                   |
| `status_type` | string  |     ✅    | `"on_track"`                                               | The type of status update. Must be one of: on\_track (project is on track), at\_risk (project is at risk), off\_track (project is off track), on\_hold (project is on hold), complete (project is complete). |

***

### `Asana Create Subtask`

Integration name: **ASANA\_CREATE\_SUBTASK**

Creates a new Asana subtask under an existing parent task (`task_gid`); `due_on` and `due_at` are mutually exclusive and cannot be set simultaneously.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example                                         | Description                                                                                                                                                                                         |
| ----------- | ------- | :------: | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`      | string  |     ✅    | `"Complete subtask"`                            | The name of the subtask to be created.                                                                                                                                                              |
| `notes`     | string  |          | `"This subtask involves reviewing section 2.1"` | Optional descriptive text for the subtask.                                                                                                                                                          |
| `due_at`    | string  |          | `"2024-03-15T14:00:00Z"`                        | Optional due date and time for the subtask in ISO 8601 format (e.g., YYYY-MM-DDTHH:mm:ssZ), which is more specific than `due_on`.                                                                   |
| `due_on`    | string  |          | `"2024-03-15"`                                  | Optional due date for the subtask in YYYY-MM-DD format, representing the end of the day for the task.                                                                                               |
| `assignee`  | string  |          | `"1234567890123456"`                            | User to assign to this subtask. Accepts either a numeric user GID (e.g., '1234567890123456') or the special value 'me' for the authenticated user. If not provided, the subtask will be unassigned. |
| `task_gid`  | string  |     ✅    | `"12345"`                                       | The numeric Global ID (GID) of the parent task under which the subtask will be created. Must be a numeric string (digits only). Special values like 'me' are not accepted.                          |
| `completed` | boolean |          | `true`                                          | Optional flag to mark the subtask as completed upon creation. Defaults to false if not specified.                                                                                                   |
| `followers` | array   |          | `["12345","67890"]`                             | Optional array of user Global IDs (GIDs) to add as followers to the subtask. Followers receive notifications about subtask updates.                                                                 |

***

### `Asana Create Tag`

Integration name: **ASANA\_CREATE\_TAG**

Tool to create a new tag in an Asana workspace. Use when you need to create a tag for categorizing tasks. Tags help organize and filter tasks across projects but are not automatically applied to any tasks.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                             | Description                                                                                                                           |
| ------------ | ------- | :------: | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `data`       | object  |     ✅    | —                                   | The properties for the tag to be created.                                                                                             |
| `opt_fields` | array   |          | `["name","color","workspace.name"]` | List of field names to include in the response. Common fields: color, created\_at, followers, name, notes, permalink\_url, workspace. |
| `opt_pretty` | boolean |          | —                                   | If true, provides pretty-printed JSON response. Useful for debugging but may increase response size.                                  |

***

### `Asana Create Task Comment`

Integration name: **ASANA\_CREATE\_TASK\_COMMENT**

Adds a new text comment (story) to an existing Asana task, appearing in its activity feed.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                           | Description                                                                                                        |
| --------- | ------ | :------: | --------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `text`    | string |     ✅    | `"This is a comment on the task"` | The plain text content of the comment to be posted on the task. HTML or rich text is not supported via this field. |
| `task_id` | string |     ✅    | `"1234567890"`                    | The globally unique identifier (GID) of the Asana task to which the comment will be added.                         |

***

### `Asana Create Team`

Integration name: **ASANA\_CREATE\_TEAM**

Tool to create a new team in an Asana workspace. Use when you need to establish a new team for collaboration.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example | Description                           |
| --------- | ------ | :------: | ------- | ------------------------------------- |
| `data`    | object |     ✅    | —       | The request data for creating a team. |

***

### `Asana Delete Allocation`

Integration name: **ASANA\_DELETE\_ALLOCATION**

Tool to delete an allocation by its ID. Use this when you need to remove a specific resource allocation in Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example   | Description                                                                                                                                                                                                                                                                         |
| ---------------- | ------- | :------: | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_pretty`     | boolean |          | —         | Provides “pretty” output. Provides the response in a “pretty” 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. |
| `allocation_gid` | string  |     ✅    | `"12345"` | Globally unique identifier for the allocation.                                                                                                                                                                                                                                      |

***

### `Asana Delete Attachment`

Integration name: **ASANA\_DELETE\_ATTACHMENT**

Tool to delete an attachment by its globally unique identifier. Use when you need to remove an existing attachment from Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example   | Description                                    |
| ---------------- | ------- | :------: | --------- | ---------------------------------------------- |
| `opt_pretty`     | boolean |          | —         | Provides “pretty” output.                      |
| `attachment_gid` | string  |     ✅    | `"12345"` | Globally unique identifier for the attachment. |

***

### `Asana Delete Custom Field`

Integration name: **ASANA\_DELETE\_CUSTOM\_FIELD**

Tool to delete a custom field by its globally unique identifier. Use when you need to remove an existing custom field from Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example   | Description                                      |
| ------------------ | ------ | :------: | --------- | ------------------------------------------------ |
| `custom_field_gid` | string |     ✅    | `"12345"` | Globally unique identifier for the custom field. |

***

### `Asana Delete Membership`

Integration name: **ASANA\_DELETE\_MEMBERSHIP**

Tool to delete a membership by its GID. Use this when you need to remove a user or team's access to a project, portfolio, goal, or custom field in Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example   | Description                                                                                                                                                                                                                                                                         |
| ---------------- | ------- | :------: | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_pretty`     | boolean |          | —         | Provides "pretty" output. Provides the response in a "pretty" 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. |
| `membership_gid` | string  |     ✅    | `"12345"` | Globally unique identifier for the membership.                                                                                                                                                                                                                                      |

***

### `Asana Delete Project`

Integration name: **ASANA\_DELETE\_PROJECT**

Delete a project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example   | Description                                                                                                                                                                                                                                               |
| ------------- | ------- | :------: | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_pretty`  | boolean |          | —         | Provides the response in a “pretty” 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. |
| `project_gid` | string  |     ✅    | `"12345"` | Globally unique identifier for the project.                                                                                                                                                                                                               |

***

### `Asana Delete Project Brief`

Integration name: **ASANA\_DELETE\_PROJECT\_BRIEF**

Tool to delete a project brief by its GID. Use when you need to remove a project brief from Asana. Note: This requires the project\_brief\_gid (not the project\_gid).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example   | Description                                                                                                                                                                                                                                                                       |
| ------------------- | ------- | :------: | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_pretty`        | boolean |          | —         | Provides "pretty" output. Provides the response in a pretty 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. |
| `project_brief_gid` | string  |     ✅    | `"12345"` | Globally unique identifier for the project brief to delete. Must be a numeric string.                                                                                                                                                                                             |

***

### `Asana Delete Project Status`

Integration name: **ASANA\_DELETE\_PROJECT\_STATUS**

Tool to delete a project status by its GID. Use when you need to remove a specific project status update from Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example    | Description                                                                                                                                                                                                                                                                       |
| -------------------- | ------- | :------: | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_pretty`         | boolean |          | —          | Provides "pretty" output. Provides the response in a pretty 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. |
| `project_status_gid` | string  |     ✅    | `"321654"` | Globally unique identifier for the project status to delete. Must be a numeric string.                                                                                                                                                                                            |

***

### `Asana Delete Section`

Integration name: **ASANA\_DELETE\_SECTION**

Tool to delete a section by its GID. Use when you need to permanently remove a section from a project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example    | Description                                                                                                                                                                                                                                                                       |
| ------------- | ------- | :------: | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_pretty`  | boolean |          | —          | Provides "pretty" output. Provides the response in a pretty 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. |
| `section_gid` | string  |     ✅    | `"321654"` | The globally unique identifier for the section to delete.                                                                                                                                                                                                                         |

***

### `Asana Delete Status Update`

Integration name: **ASANA\_DELETE\_STATUS\_UPDATE**

Tool to delete a status update by its GID. Use when you need to remove a specific status update from Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example    | Description                                                                                                                                                                                                                                                                       |
| ------------------- | ------- | :------: | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_pretty`        | boolean |          | —          | Provides "pretty" output. Provides the response in a pretty 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. |
| `status_update_gid` | string  |     ✅    | `"321654"` | Globally unique identifier for the status update to delete.                                                                                                                                                                                                                       |

***

### `Asana Delete Story`

Integration name: **ASANA\_DELETE\_STORY**

Tool to delete a story by its GID. Use when you need to remove a story from Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example   | Description                                                                                                                                                                                                                                                                       |
| ------------ | ------- | :------: | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `story_gid`  | string  |     ✅    | `"35678"` | Globally unique identifier for the story.                                                                                                                                                                                                                                         |
| `opt_pretty` | boolean |          | —         | Provides "pretty" output. Provides the response in a pretty 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. |

***

### `Asana Delete Tag`

Integration name: **ASANA\_DELETE\_TAG**

Tool to delete a specific tag by its GID. Use when you need to remove an existing tag from Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example   | Description                                                                                                                                                                                                                             |
| ------------ | ------- | :------: | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tag_gid`    | string  |     ✅    | `"12345"` | The globally unique identifier for the tag.                                                                                                                                                                                             |
| `opt_pretty` | boolean |          | —         | Provides “pretty” output. 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. |

***

### `Asana Delete Task`

Integration name: **ASANA\_DELETE\_TASK**

Delete a task.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example   | Description                                                                                                                                                                                                                                                                         |
| ------------ | ------- | :------: | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `task_gid`   | string  |     ✅    | `"12345"` | Globally unique identifier for the task to delete. Must be a numeric string.                                                                                                                                                                                                        |
| `opt_pretty` | boolean |          | —         | Provides "pretty" output. Provides the response in a "pretty" 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. |

***

### `Asana Duplicate Project`

Integration name: **ASANA\_DUPLICATE\_PROJECT**

Duplicate a project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                    | Description                                                                  |
| ---------------- | ------ | :------: | -------------------------- | ---------------------------------------------------------------------------- |
| `name`           | string |     ✅    | `"New Project Name"`       | The name of the new project.                                                 |
| `team`           | string |          | `"67890"`                  | Globally unique identifier for the team that the new project will belong to. |
| `include`        | array  |          | `["members","task_notes"]` | A list of elements to be included in the duplication.                        |
| `project_gid`    | string |     ✅    | `"12345"`                  | Globally unique identifier for the project to be duplicated.                 |
| `schedule_dates` | object |          | —                          | Scheduling information for the new project.                                  |

***

### `Asana Duplicate Task`

Integration name: **ASANA\_DUPLICATE\_TASK**

Duplicate a task

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example           | Description                                                            |
| ---------- | ------ | :------: | ----------------- | ---------------------------------------------------------------------- |
| `name`     | string |          | `"New Task Name"` | The name of the new task.                                              |
| `include`  | array  |          | —                 | A comma-separated string of properties to copy from the original task. |
| `task_gid` | string |     ✅    | `"12345"`         | The globally unique identifier for the task to be duplicated.          |

***

### `Asana Get Access Requests`

Integration name: **ASANA\_GET\_ACCESS\_REQUESTS**

Tool to retrieve access requests for a target object. Use when you need to get pending access requests for a specific resource like a project or portfolio.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                               | Description                                                                                                                                                                                                                             |
| ------------ | ------- | :------: | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`       | string  |          | `"me"`                                                                | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                                                        |
| `target`     | string  |     ✅    | `"1331"`                                                              | Globally unique identifier for the target object.                                                                                                                                                                                       |
| `opt_fields` | array   |          | `["approval_status","message","requester","requester.name","target"]` | 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.                             |
| `opt_pretty` | boolean |          | —                                                                     | Provides "pretty" output. 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. |

***

### `Asana Get Allocation`

Integration name: **ASANA\_GET\_ALLOCATION**

Get an allocation by ID. Use when you need to retrieve the details of a specific allocation.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                              | Description                                                                                                                                                                                                                             |
| ---------------- | ------- | :------: | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`     | array   |          | `["assignee","created_by","effort"]` | 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.                             |
| `opt_pretty`     | boolean |          | —                                    | Provides “pretty” output. 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. |
| `allocation_gid` | string  |     ✅    | `"12345"`                            | Globally unique identifier for the allocation.                                                                                                                                                                                          |

***

### `Asana Get Allocations`

Integration name: **ASANA\_GET\_ALLOCATIONS**

Tool to get multiple allocations. Requires either 'parent' (project GID) OR both 'assignee' AND 'workspace' together.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example | Description                                                                                                                                                                                                 |
| ------------ | ------- | :------: | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `10`    | Results per page.                                                                                                                                                                                           |
| `offset`     | string  |          | —       | Offset token.                                                                                                                                                                                               |
| `parent`     | string  |          | —       | Globally unique identifier for the project to filter allocations by. Required if 'assignee' and 'workspace' are not both provided.                                                                          |
| `assignee`   | string  |          | —       | Globally unique identifier for the user or placeholder the allocation is assigned to. Must be provided together with 'workspace' if 'parent' is not specified.                                              |
| `workspace`  | string  |          | —       | Globally unique identifier for the workspace. Must be provided together with 'assignee' if 'parent' is not specified.                                                                                       |
| `opt_fields` | array   |          | —       | 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. |
| `opt_pretty` | boolean |          | `true`  | Provides 'pretty' output.                                                                                                                                                                                   |

***

### `Asana Get A Project`

Integration name: **ASANA\_GET\_A\_PROJECT**

Retrieves a specific Asana project by its `project_gid`, with an option to include additional fields for comprehensive details using `opt_fields`; this action does not return tasks within the project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example              | Description                                                                                                                                                                                           |
| ------------- | ------- | :------: | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`  | array   |          | `"archived"`         | Defines a comma-separated list of optional fields for a more detailed project representation in the response, beyond the default compact view.                                                        |
| `opt_pretty`  | boolean |          | —                    | Pretty-prints the JSON response for readability, useful for debugging.                                                                                                                                |
| `project_gid` | string  |     ✅    | `"1234567890123456"` | Globally unique identifier for the project. Must be a numeric string (e.g., '1234567890123456'). Use ASANA\_GET\_MULTIPLE\_PROJECTS or ASANA\_GET\_WORKSPACE\_PROJECTS to retrieve valid project IDs. |

***

### `Asana Get A Task`

Integration name: **ASANA\_GET\_A\_TASK**

Retrieves full details for a specified task GID accessible by the user; use `opt_fields` to customize returned data.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                 | Description                                                                                                                                                                                                                                                                                                                          |
| ------------ | ------- | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `task_gid`   | string  |     ✅    | `"1202179584851234"`    | Globally unique identifier (GID) of the task.                                                                                                                                                                                                                                                                                        |
| `opt_fields` | array   |          | `["assignee","due_on"]` | Array of field names to include in the response for more detailed data beyond the default compact representation. Only specific field paths listed in the OptFieldsEnm0 enum are supported (not arbitrary nested paths). Examples of valid fields: assignee, due\_on, name, notes, custom\_fields.name, followers.name, parent.name. |
| `opt_pretty` | boolean |          | —                       | If true, formats JSON response with indentation for readability; for debugging, as it increases response size/time.                                                                                                                                                                                                                  |

***

### `Asana Get Attachment`

Integration name: **ASANA\_GET\_ATTACHMENT**

Tool to get a single attachment by its globally unique identifier. Use when you need to retrieve details about a specific file attached to a task or project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example           | Description                                                                                |
| ---------------- | ------ | :------: | ----------------- | ------------------------------------------------------------------------------------------ |
| `opt_fields`     | string |          | `"name,size,url"` | A comma-separated list of fields to include in the response. For example: "name,size,url". |
| `attachment_gid` | string |     ✅    | `"12345"`         | The globally unique identifier for the attachment.                                         |

***

### `Asana Get Audit Log Events`

Integration name: **ASANA\_GET\_AUDIT\_LOG\_EVENTS**

Tool to get audit log events for a workspace. Use when you need to retrieve a log of actions performed within a specific Asana workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                  | Description                                                                                                                                                                                                                                                |
| --------------- | ------- | :------: | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | `50`                     | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                           |
| `end_at`        | string  |          | `"2023-10-27T10:00:00Z"` | Filter to events created before this time (exclusive).                                                                                                                                                                                                     |
| `offset`        | string  |          | `"abcdef123456"`         | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. |
| `start_at`      | string  |          | `"2023-10-26T10:00:00Z"` | Filter to events created after this time (inclusive).                                                                                                                                                                                                      |
| `actor_gid`     | string  |          | `"12345"`                | Filter to events triggered by the actor with this ID.                                                                                                                                                                                                      |
| `actor_type`    | string  |          | `"user"`                 | Filter to events with an actor of this type. This only needs to be included if querying for actor types without an ID. If actor\_gid is included, this should be excluded.                                                                                 |
| `event_type`    | string  |          | `"task_created"`         | Filter to events of this type. Refer to the supported audit log events for a full list of values.                                                                                                                                                          |
| `resource_gid`  | string  |          | `"12345"`                | Filter to events with this resource ID.                                                                                                                                                                                                                    |
| `workspace_gid` | string  |     ✅    | `"12345"`                | Globally unique identifier for the workspace or organization.                                                                                                                                                                                              |

***

### `Asana Get A User Task List`

Integration name: **ASANA\_GET\_A\_USER\_TASK\_LIST**

Retrieves a specific user's task list from Asana by its `user_task_list_gid`, optionally returning extended details like name, owner, and workspace if specified in `opt_fields`.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example              | Description                                                                                                                                                                                                                                                                                    |
| -------------------- | ------- | :------: | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `workspace`          | string  |     ✅    | `"1205766922013215"` | The GID of the workspace to filter the user task list.                                                                                                                                                                                                                                         |
| `opt_fields`         | array   |          | `"name"`             | A list of optional field names to include in the response. By default, the response is compact and excludes some properties. Use this parameter to retrieve additional details. For example, to include the owner and workspace, provide `["owner", "workspace"]` as the value for this field. |
| `opt_pretty`         | boolean |          | —                    | Set to true to receive the API response in a pretty-printed JSON format. This is useful for debugging but may increase response size and processing time.                                                                                                                                      |
| `user_task_list_gid` | string  |     ✅    | `"me"`               | The user GID (not task list GID) to retrieve the task list for. This endpoint retrieves a user's task list by user GID, not by task list GID. Use 'me' for the authenticated user or a specific user GID.                                                                                      |

***

### `Asana Get Current User`

Integration name: **ASANA\_GET\_CURRENT\_USER**

Retrieves the authenticated user's full record, including accessible workspaces, often used as an initial call to establish user context for subsequent operations.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Asana Get Custom Field`

Integration name: **ASANA\_GET\_CUSTOM\_FIELD**

Tool to get a single custom field by its globally unique identifier. Use when you need to retrieve the complete metadata and properties of a specific custom field in Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                                 | Description                                                                                                                                                                                                 |
| ------------------ | ------- | :------: | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`       | array   |          | `["name","description","enum_options"]` | 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. |
| `opt_pretty`       | boolean |          | `true`                                  | Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable.                                                                  |
| `custom_field_gid` | string  |     ✅    | `"12345"`                               | Globally unique identifier for the custom field.                                                                                                                                                            |

***

### `Asana Get Custom Fields For Workspace`

Integration name: **ASANA\_GET\_CUSTOM\_FIELDS\_FOR\_WORKSPACE**

Tool to get all custom fields in a workspace. Use when you need to retrieve a list of custom fields associated with a specific workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                  | Description                                                                                                                                                                                                                             |
| --------------- | ------- | :------: | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | —                        | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                        |
| `offset`        | string  |          | —                        | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request.                                                            |
| `opt_fields`    | array   |          | `["name","description"]` | This endpoint returns a compact 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.                    |
| `opt_pretty`    | boolean |          | —                        | Provides “pretty” output. 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. |
| `workspace_gid` | string  |     ✅    | `"12345"`                | Globally unique identifier for the workspace or organization.                                                                                                                                                                           |

***

### `Asana Get Custom Types`

Integration name: **ASANA\_GET\_CUSTOM\_TYPES**

Tool to get all custom types associated with a project. Use when you need to retrieve custom types that extend Asana objects for categorization purposes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                            | Description                                                                                                                                                                                                                                                |
| ------------ | ------- | :------: | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `50`                                               | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                           |
| `offset`     | string  |          | `"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9"`           | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. |
| `project`    | string  |     ✅    | `"1331"`                                           | Globally unique identifier for the project, which is used as a filter when retrieving all custom types.                                                                                                                                                    |
| `opt_fields` | array   |          | `["name","status_options","status_options.color"]` | 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.                                                |
| `opt_pretty` | boolean |          | —                                                  | Provides "pretty" output. 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.                    |

***

### `Asana Get Events`

Integration name: **ASANA\_GET\_EVENTS**

Retrieve events on a resource to monitor changes. Use when you need to track activity or changes related to a specific Asana resource like a task, project, or tag.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------- | ------- | :------: | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sync`         | string  |          | `"de4774f6915eae04714ca93bb2f5ee81:0"`        | A sync token received from a previous events GET request. If provided, the API will return only events that have occurred since the sync token was created. If omitted, the API will return all events.                                                                                                                                                                                                                                                                                      |
| `opt_fields`   | array   |          | `["action","resource","parent","created_at"]` | Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options. |
| `opt_pretty`   | boolean |          | —                                             | Provides “pretty” output. Provides the response in a “pretty” format. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                                                                                                                                                                                                                                                         |
| `resource_gid` | string  |     ✅    | `"12345"`                                     | Globally unique identifier for the resource.                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

***

### `Asana Get Favorites For User`

Integration name: **ASANA\_GET\_FAVORITES\_FOR\_USER**

Tool to get a user's favorites within a specified workspace. Returns favorites ordered as they appear in the user's Asana sidebar.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                  | Description                                                                                                                                                                                                                                                                                                                                                  |
| --------------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`         | integer |          | `50`                                     | Results per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                                                                       |
| `offset`        | string  |          | `"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9"` | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
| `user_gid`      | string  |     ✅    | `"me"`                                   | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                                                                                                                                                                             |
| `workspace`     | string  |     ✅    | `"1234"`                                 | The workspace in which to get favorites.                                                                                                                                                                                                                                                                                                                     |
| `opt_fields`    | array   |          | `["name","offset","path","uri"]`         | 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.                                                                                                                                                  |
| `opt_pretty`    | boolean |          | —                                        | Provides 'pretty' output. Provides the response in a pretty 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.                                                                            |
| `resource_type` | string  |          | —                                        | The resource type of favorites to be returned.                                                                                                                                                                                                                                                                                                               |

***

### `Asana Get Goal`

Integration name: **ASANA\_GET\_GOAL**

Retrieve the full record for a single goal by its GID.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example | Description                                                                              |
| ------------ | ------ | :------: | ------- | ---------------------------------------------------------------------------------------- |
| `goal_gid`   | string |     ✅    | —       | Globally unique identifier for the goal.                                                 |
| `opt_fields` | string |          | —       | Comma-separated list of fields to include in the response. Example: "name,notes,due\_on" |

***

### `Asana Get Goal Relationships`

Integration name: **ASANA\_GET\_GOAL\_RELATIONSHIPS**

Tool to retrieve goal relationships. Use when you need to get the relationships associated with a specific goal in Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example          | Description                                  |
| ------------ | ------- | :------: | ---------------- | -------------------------------------------- |
| `limit`      | integer |          | `20`             | The number of objects to return per page.    |
| `offset`     | string  |          | `"abcdefg"`      | Offset token for pagination.                 |
| `goal_gid`   | string  |     ✅    | `"12345"`        | The globally unique identifier for the goal. |
| `opt_fields` | array   |          | `["name","gid"]` | Defines fields to return.                    |
| `opt_pretty` | boolean |          | `true`           | Provides “pretty” output.                    |

***

### `Asana Get Goals`

Integration name: **ASANA\_GET\_GOALS**

Tool to retrieve multiple goals. Requires exactly one scope parameter (workspace, team, portfolio, or project) to be specified. Can be optionally filtered by time period or archived status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example     | Description                                                                                                                                                                                                                                                    |
| -------------------- | ------- | :------: | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `team`               | string  |          | `"14916"`   | Globally unique identifier for the team. Exactly one of workspace, team, portfolio, or project must be specified.                                                                                                                                              |
| `limit`              | integer |          | `20`        | The number of results to return.                                                                                                                                                                                                                               |
| `offset`             | string  |          | `"abcdefg"` | Offset token for pagination.                                                                                                                                                                                                                                   |
| `project`            | string  |          | `"12345"`   | Globally unique identifier for the project. Exactly one of workspace, team, portfolio, or project must be specified.                                                                                                                                           |
| `archived`           | boolean |          | `false`     | Filter to archived goals.                                                                                                                                                                                                                                      |
| `portfolio`          | string  |          | `"12345"`   | Globally unique identifier for the portfolio. Exactly one of workspace, team, portfolio, or project must be specified.                                                                                                                                         |
| `workspace`          | string  |          | `"12345"`   | Globally unique identifier for the workspace or organization. Exactly one of workspace, team, portfolio, or project must be specified.                                                                                                                         |
| `opt_fields`         | array   |          | —           | Defines fields to return. Some requests support structured objects supporting cascades of multiple objects separated by commas; "data.gid" will return the gid field of the data object or "data.subtask.gid" will return the gid field of the subtask object. |
| `time_period`        | string  |          | `"12345"`   | Globally unique identifier for the time period.                                                                                                                                                                                                                |
| `is_workspace_level` | boolean |          | `true`      | Filter to goals at the workspace level.                                                                                                                                                                                                                        |

***

### `Asana Get Job`

Integration name: **ASANA\_GET\_JOB**

Tool to retrieve a job by its globally unique identifier. Use when you need to check the status of asynchronous operations like task duplication, project instantiation, or exports.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                                                                                                                                                                                                                                                                                                                                                                                        | Description                                                                                                                                                                                                                                                                  |
| ------------ | ------- | :------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `job_gid`    | string  |     ✅    | `"12345"`                                                                                                                                                                                                                                                                                                                                                                                                                                      | Globally unique identifier for the job.                                                                                                                                                                                                                                      |
| `opt_fields` | array   |          | `["new_graph_export","new_graph_export.completed_at","new_graph_export.created_at","new_graph_export.download_url","new_project","new_project.name","new_project_template","new_project_template.name","new_resource_export","new_resource_export.completed_at","new_resource_export.created_at","new_resource_export.download_url","new_task","new_task.created_by","new_task.name","new_task.resource_subtype","resource_subtype","status"]` | A comma-separated list of properties to include in the response. 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. |
| `opt_pretty` | boolean |          | —                                                                                                                                                                                                                                                                                                                                                                                                                                              | If true, provides "pretty" (i.e., human-readable) JSON output. Formatting dates and times as human-readable strings, numbers as strings, and including newlines and indentation.                                                                                             |

***

### `Asana Get Membership`

Integration name: **ASANA\_GET\_MEMBERSHIP**

Tool to retrieve a single membership by its ID. Use this when you need to get details about a specific membership relationship between a user/team and a goal, project, portfolio, or custom field.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example   | Description                                                                                                                              |
| ---------------- | ------- | :------: | --------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_pretty`     | boolean |          | —         | Provides "pretty" output. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
| `membership_gid` | string  |     ✅    | `"12345"` | Globally unique identifier for the membership.                                                                                           |

***

### `Asana Get Memberships`

Integration name: **ASANA\_GET\_MEMBERSHIPS**

Tool to retrieve memberships for goals, projects, portfolios, or custom fields. Use this to find out who has access to a specific Asana resource or what resources a specific user/team has access to.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                | Description                                                                                                              |
| ------------ | ------- | :------: | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| `limit`      | integer |          | `20`                                                   | The number of results to return per page.                                                                                |
| `member`     | string  |          | `"67890"`                                              | GID of the member (user or team) to filter memberships.                                                                  |
| `offset`     | string  |          | `"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9..."`            | Offset token for pagination.                                                                                             |
| `parent`     | string  |          | `"12345"`                                              | GID of the parent resource (e.g., project\_gid, goal\_gid, portfolio\_gid, or custom\_field\_gid) to filter memberships. |
| `opt_fields` | string  |          | `"parent,member,access_level,parent.name,member.name"` | Comma-separated list of fields to include in the response (e.g., "parent,member,access\_level,parent.name,member.name"). |

***

### `Asana Get Multiple Projects`

Integration name: **ASANA\_GET\_MULTIPLE\_PROJECTS**

Returns a list of projects filtered by workspace or team (one required), with optional archived status filter, supporting pagination for large datasets.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                    | Description                                                                                                                                                                                                                                                                                                    |
| ------------ | ------- | :------: | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `team`       | string  |          | `"1205029116228052"`       | GID of the team to filter projects by. Either workspace OR team is REQUIRED. GIDs are numeric strings (digits only, e.g., '1205029116228052').                                                                                                                                                                 |
| `limit`      | integer |          | `"20"`                     | Number of projects to return per page (1-100).                                                                                                                                                                                                                                                                 |
| `offset`     | string  |          | `"eyJ...example.token..."` | Pagination offset token (JWT format) from a previous response's `next_page.offset` field. IMPORTANT: Use the COMPLETE token exactly as returned - tokens are long strings (\~150-200 characters) with three base64 sections separated by dots (header.payload.signature). Do NOT truncate or modify the token. |
| `archived`   | boolean |          | `"false"`                  | Filter projects by archived status: `True` for archived only, `False` for unarchived only.                                                                                                                                                                                                                     |
| `workspace`  | string  |          | `"1205029116228052"`       | GID of the workspace or organization to filter projects by. Either workspace OR team is REQUIRED. GIDs are numeric strings (digits only, e.g., '1205029116228052'). To find your workspace GID, call GET /workspaces.                                                                                          |
| `opt_fields` | array   |          | `"name,archived,color"`    | Array of optional properties to include for richer project details, as the default response is compact. This is an array, not a comma-separated string. See `OptFieldsEnm0` for available fields.                                                                                                              |
| `opt_pretty` | boolean |          | `"false"`                  | Return JSON in a 'pretty' format (indented, line breaks). For debugging only due to increased response size/time.                                                                                                                                                                                              |

***

### `Asana Get Multiple Tasks`

Integration name: **ASANA\_GET\_MULTIPLE\_TASKS**

Retrieves a list of tasks, allowing filtering by assignee (requires `workspace`), project, section, `completed_since`, and `modified_since`; `workspace` also requires `assignee`.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                                 | Description                                                                                                                                                                                                                                                              |
| ----------------- | ------- | :------: | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `tag`             | string  |          | `"1234567890"`                          | Tag GID to filter tasks. Mutually exclusive with project, section, user\_task\_list, or assignee+workspace.                                                                                                                                                              |
| `limit`           | integer |          | `20`                                    | Number of task objects to return per page (1-100). Required when using assignee+workspace; defaults to 50 if omitted for that filter combination.                                                                                                                        |
| `offset`          | string  |          | `"eyJ...example.token..."`              | Offset token for pagination, from next\_page in a previous response. WARNING: Tokens expire after a short time. Use fresh tokens from recent API responses; do not cache for extended periods. If a token expires, restart pagination from the first page (omit offset). |
| `project`         | string  |          | `"1234567890"`                          | Project GID to filter tasks. Mutually exclusive with section, tag, user\_task\_list, or assignee+workspace.                                                                                                                                                              |
| `section`         | string  |          | `"1234567890"`                          | Section GID to filter tasks. Mutually exclusive with project, tag, user\_task\_list, or assignee+workspace.                                                                                                                                                              |
| `assignee`        | string  |          | `"1234567890"`                          | User identifier: 'me' for current user or a numeric GID. Must be used with `workspace`. When using assignee+workspace, always set a `limit` (defaults to 50 if omitted).                                                                                                 |
| `workspace`       | string  |          | `"1234567890"`                          | Workspace GID. Must be used with `assignee`. Mutually exclusive with project, section, tag, or user\_task\_list.                                                                                                                                                         |
| `opt_fields`      | array   |          | `["assignee","due_on","projects.name"]` | Optional fields to include. Use 'projects' (plural) for project data. See OptFieldsEnm0 for valid values.                                                                                                                                                                |
| `opt_pretty`      | boolean |          | `true`                                  | Format JSON output with indentation for debugging (may increase response time/size).                                                                                                                                                                                     |
| `modified_since`  | string  |          | `"2023-01-15T12:00:00.000Z"`            | ISO 8601 date-time. Returns tasks modified since this time (includes property/association changes).                                                                                                                                                                      |
| `user_task_list`  | string  |          | `"1234567890"`                          | User task list GID to filter tasks. Mutually exclusive with project, section, tag, or assignee+workspace.                                                                                                                                                                |
| `completed_since` | string  |          | `"2023-01-01T00:00:00.000Z"`            | Filter for tasks incomplete or completed since this ISO 8601 date-time or 'now'.                                                                                                                                                                                         |

***

### `Asana Get Multiple Users`

Integration name: **ASANA\_GET\_MULTIPLE\_USERS**

Returns a list of users in an Asana workspace or organization, optionally filtered by workspace or team GID, with support for pagination and specifying optional fields.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                    | Description                                                                                                                                                                                                               |
| ------------ | ------- | :------: | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `team`       | string  |          | `"112233445566778"`                                        | The GID of the Asana team. Required when the authenticated user belongs to multiple workspaces (at least one of 'workspace' or 'team' must be provided). Filters results to users in this team.                           |
| `limit`      | integer |          | —                                                          | The maximum number of user objects to return per page (1-100).                                                                                                                                                            |
| `offset`     | string  |          | —                                                          | Opaque token for pagination to retrieve the subsequent page of results.                                                                                                                                                   |
| `workspace`  | string  |          | `"123456789012345"`                                        | The GID of the Asana workspace or organization. Required when the authenticated user belongs to multiple workspaces (at least one of 'workspace' or 'team' must be provided). Filters results to users in this workspace. |
| `opt_fields` | array   |          | `["email","name","photo.image_128x128","workspaces.name"]` | A list of optional field names to include in the response for each user. Available fields include 'email', 'name', 'photo' (and its specific sizes like 'photo.image\_1024x1024'), 'workspaces', 'uri', and 'offset'.     |
| `opt_pretty` | boolean |          | —                                                          | Return the response in a human-readable JSON format.                                                                                                                                                                      |

***

### `Asana Get Multiple Workspaces`

Integration name: **ASANA\_GET\_MULTIPLE\_WORKSPACES**

Retrieves all workspaces accessible by the authenticated user, returning an empty list if the user has no accessible workspaces.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                               | Description                                                                                                                                                                                                                                     |
| ------------ | ------- | :------: | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `20`                                  | The maximum number of workspace objects to return per page. Must be an integer between 1 and 100, inclusive.                                                                                                                                    |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"                   | An opaque token used for pagination, obtained from the 'next\_page' object in a previous response. If not provided, the first page of results is returned. Note: Pass only an offset token from a previous paginated request for this endpoint. |
| `opt_fields` | array   |          | `["email_domains","is_organization"]` | A comma-separated list of optional properties to include in the response. By default, only a compact representation of the resource is returned. Available options: 'email\_domains', 'is\_organization', 'name', 'offset', 'path', 'uri'.      |
| `opt_pretty` | boolean |          | —                                     | Set to true to receive the response in a human-readable JSON format with proper line breaking and indentation. Useful for debugging, but may increase response time and size.                                                                   |

***

### `Asana Get Portfolio`

Integration name: **ASANA\_GET\_PORTFOLIO**

Retrieve the full record for a single portfolio by its GID. Use this when you need to get detailed information about a specific portfolio.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example | Description                                                      |
| --------------- | ------- | :------: | ------- | ---------------------------------------------------------------- |
| `limit`         | integer |          | —       | Results per page. Max 100.                                       |
| `offset`        | string  |          | —       | Offset token for pagination.                                     |
| `opt_fields`    | array   |          | —       | Defines fields to return. Example: \["name", "color", "due\_on"] |
| `opt_pretty`    | boolean |          | —       | Provides “pretty” output.                                        |
| `portfolio_gid` | string  |     ✅    | —       | Globally unique identifier for the portfolio.                    |

***

### `Asana Get Portfolio Items`

Integration name: **ASANA\_GET\_PORTFOLIO\_ITEMS**

Retrieve items in a portfolio. Use this to get a list of projects or other portfolios contained within a specific portfolio.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                     | Description                                                                                                                                                            |
| --------------- | ------- | :------: | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | `20`                        | Number of results to return per page.                                                                                                                                  |
| `offset`        | string  |          | `"eyJ0eXAiOJiV...`"         | Offset token to request next page.                                                                                                                                     |
| `opt_fields`    | array   |          | `["name","owner","due_on"]` | Fields to include in response. Common fields: archived, color, created\_at, current\_status\_update, due\_on, members, name, notes, owner, start\_on, team, workspace. |
| `portfolio_gid` | string  |     ✅    | `"12345"`                   | Globally unique identifier for the portfolio.                                                                                                                          |

***

### `Asana Get Portfolio Memberships`

Integration name: **ASANA\_GET\_PORTFOLIO\_MEMBERSHIPS**

Tool to retrieve multiple portfolio memberships. Use this tool when you need to list memberships for a specific portfolio, a user within a portfolio, or a user across all portfolios in a workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------ | ------- | :------: | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `user`       | string  |          | `"me"`                                       | A string identifying a user. This can either be the string "me", an email, or the GID of a user.                                                                                                                                                                                                                                                                                                                               |
| `limit`      | integer |          | —                                            | Results per page. The number of objects to return per page. Must be between 1 and 100, inclusive.                                                                                                                                                                                                                                                                                                                              |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"                          | Offset token. An offset to paginate from. This can be retrieved from the ‘next\_page’ field in the previous response.                                                                                                                                                                                                                                                                                                          |
| `portfolio`  | string  |          | `"12345"`                                    | The GID of the portfolio to filter memberships on.                                                                                                                                                                                                                                                                                                                                                                             |
| `workspace`  | string  |          | `"67890"`                                    | The GID of the workspace to filter memberships on.                                                                                                                                                                                                                                                                                                                                                                             |
| `opt_fields` | array   |          | `["user.name","portfolio.name","workspace"]` | Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The id of included objects will always be returned, regardless of the field options. |

***

### `Asana Get Portfolios`

Integration name: **ASANA\_GET\_PORTFOLIOS**

Retrieve multiple portfolios. Use when you need to list portfolios within a specific workspace, optionally filtered by owner.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example | Description                                                                                                                            |
| ------------ | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | —       | The number of objects to return per page. Must be between 1 and 100.                                                                   |
| `owner`      | string  |     ✅    | —       | The user GID who owns the portfolio. Use 'me' to refer to the current authenticated user. This parameter is required by the Asana API. |
| `offset`     | string  |          | —       | An offset token for pagination.                                                                                                        |
| `workspace`  | string  |     ✅    | —       | The workspace or organization GID to filter portfolios on. Must be a non-empty numeric GID (e.g., '1205766922013215').                 |
| `opt_fields` | array   |          | —       | Fields to include in the response. For example: \['name', 'color', 'owner'].                                                           |

***

### `Asana Get Project Brief`

Integration name: **ASANA\_GET\_PROJECT\_BRIEF**

Tool to retrieve a project brief by its GID. Use when you need to get the detailed explanation (what and why) of a project. Note: Requires the project\_brief\_gid (not the project\_gid). First call 'Get a project' with opt\_fields=\['project\_brief'] to obtain the project\_brief\_gid.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example              | Description                                                                                                                                                                                                                                                                               |
| ------------------- | ------- | :------: | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`        | array   |          | —                    | 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. Available options: text                                                       |
| `opt_pretty`        | boolean |          | —                    | Provides 'pretty' output. 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.                                                   |
| `project_brief_gid` | string  |     ✅    | `"1212598676699299"` | Globally unique identifier for the project brief. This is NOT the project GID. Must be a numeric string. To obtain a project\_brief\_gid, first call 'Get a project' with opt\_fields=\['project\_brief'] to retrieve the project's brief object, which contains the project\_brief\_gid. |

***

### `Asana Get Project Membership`

Integration name: **ASANA\_GET\_PROJECT\_MEMBERSHIP**

Tool to get a project membership by ID. Use when you need to retrieve details of a specific project membership.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                | Type    | Required | Example                                                                                                                     | Description                                                                                                                                                                                                                             |
| ------------------------ | ------- | :------: | --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`             | array   |          | `["access_level","member","member.name","parent","parent.name","project","project.name","user","user.name","write_access"]` | 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.                             |
| `opt_pretty`             | boolean |          | —                                                                                                                           | Provides "pretty" output. 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. |
| `project_membership_gid` | string  |     ✅    | `"1331"`                                                                                                                    | Globally unique identifier for the project membership.                                                                                                                                                                                  |

***

### `Asana Get Project Memberships`

Integration name: **ASANA\_GET\_PROJECT\_MEMBERSHIPS**

Tool to get memberships from a specific project. Use when you need to see who has access to a project and their permission levels.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                                                                                | Description                                                                                                                                                                                                 |
| ------------- | ------- | :------: | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`        | string  |          | `"me"`                                                                                 | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                            |
| `limit`       | integer |          | `50`                                                                                   | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                            |
| `offset`      | string  |          | `"eyJ0eXAiOJiV...`"                                                                    | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request.                                |
| `opt_fields`  | array   |          | `["access_level","member","member.name","offset","parent","parent.name","path","uri"]` | 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. |
| `opt_pretty`  | boolean |          | —                                                                                      | Provides "pretty" output. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                    |
| `project_gid` | string  |     ✅    | `"1331"`                                                                               | Globally unique identifier for the project.                                                                                                                                                                 |

***

### `Asana Get Projects For Task`

Integration name: **ASANA\_GET\_PROJECTS\_FOR\_TASK**

Tool to get all projects a task is in. Use when you need to retrieve project associations for a specific task.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Description                                                                                                                                                                                                                                                                                                                                                    |
| ------------ | ------- | :------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `50`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                               |
| `offset`     | string  |          | `"eyJ...example.token..."`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. *Note: You can only pass in an offset that was returned to you via a previously paginated request.* |
| `task_gid`   | string  |     ✅    | `"321654"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | The task to operate on.                                                                                                                                                                                                                                                                                                                                        |
| `opt_fields` | array   |          | `["archived","color","completed","completed_at","completed_by","completed_by.name","created_at","created_from_template","created_from_template.name","current_status","current_status.author","current_status.author.name","current_status.color","current_status.created_at","current_status.created_by","current_status.created_by.name","current_status.html_text","current_status.modified_at","current_status.text","current_status.title","current_status_update","current_status_update.resource_subtype","current_status_update.title","custom_field_settings","custom_field_settings.custom_field","custom_field_settings.custom_field.asana_created_field","custom_field_settings.custom_field.created_by","custom_field_settings.custom_field.created_by.name","custom_field_settings.custom_field.currency_code","custom_field_settings.custom_field.custom_label","custom_field_settings.custom_field.custom_label_position","custom_field_settings.custom_field.date_value","custom_field_settings.custom_field.date_value.date","custom_field_settings.custom_field.date_value.date_time","custom_field_settings.custom_field.default_access_level","custom_field_settings.custom_field.description","custom_field_settings.custom_field.display_value","custom_field_settings.custom_field.enabled","custom_field_settings.custom_field.enum_options","custom_field_settings.custom_field.enum_options.color","custom_field_settings.custom_field.enum_options.enabled","custom_field_settings.custom_field.enum_options.name","custom_field_settings.custom_field.enum_value","custom_field_settings.custom_field.enum_value.color","custom_field_settings.custom_field.enum_value.enabled","custom_field_settings.custom_field.enum_value.name","custom_field_settings.custom_field.format","custom_field_settings.custom_field.has_notifications_enabled","custom_field_settings.custom_field.id_prefix","custom_field_settings.custom_field.input_restrictions","custom_field_settings.custom_field.is_formula_field","custom_field_settings.custom_field.is_global_to_workspace","custom_field_settings.custom_field.is_value_read_only","custom_field_settings.custom_field.multi_enum_values","custom_field_settings.custom_field.multi_enum_values.color","custom_field_settings.custom_field.multi_enum_values.enabled","custom_field_settings.custom_field.multi_enum_values.name","custom_field_settings.custom_field.name","custom_field_settings.custom_field.number_value","custom_field_settings.custom_field.people_value","custom_field_settings.custom_field.people_value.name","custom_field_settings.custom_field.precision","custom_field_settings.custom_field.privacy_setting","custom_field_settings.custom_field.reference_value","custom_field_settings.custom_field.reference_value.name","custom_field_settings.custom_field.representation_type","custom_field_settings.custom_field.resource_subtype","custom_field_settings.custom_field.text_value","custom_field_settings.custom_field.type","custom_field_settings.is_important","custom_field_settings.parent","custom_field_settings.parent.name","custom_field_settings.project","custom_field_settings.project.name","custom_fields","custom_fields.date_value","custom_fields.date_value.date","custom_fields.date_value.date_time","custom_fields.display_value","custom_fields.enabled","custom_fields.enum_options","custom_fields.enum_options.color","custom_fields.enum_options.enabled","custom_fields.enum_options.name","custom_fields.enum_value","custom_fields.enum_value.color","custom_fields.enum_value.enabled","custom_fields.enum_value.name","custom_fields.id_prefix","custom_fields.input_restrictions","custom_fields.is_formula_field","custom_fields.multi_enum_values","custom_fields.multi_enum_values.color","custom_fields.multi_enum_values.enabled","custom_fields.multi_enum_values.name","custom_fields.name","custom_fields.number_value","custom_fields.representation_type","custom_fields.text_value","custom_fields.type","default_access_level","default_view","due_date","due_on","followers","followers.name","html_notes","icon","members","members.name","minimum_access_level_for_customization","minimum_access_level_for_sharing","modified_at","name","notes","offset","owner","path","permalink_url","privacy_setting","project_brief","public","start_on","team","team.name","uri","workspace","workspace.name"]` | 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.                                                                                                                                                    |
| `opt_pretty` | boolean |          | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Provides 'pretty' output. Provides the response in a 'pretty' 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.                                                                            |

***

### `Asana Get Projects For Team`

Integration name: **ASANA\_GET\_PROJECTS\_FOR\_TEAM**

Tool to get a list of projects for a specific team in Asana. Use when you need to retrieve project details associated with a team.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                          | Description                                                                                                                                                                                                 |
| ------------ | ------- | :------: | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `20`                             | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                            |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"              | Offset token. An offset to the next page returned by the API.                                                                                                                                               |
| `archived`   | boolean |          | `false`                          | Only return projects whose `archived` field takes on the value of this parameter.                                                                                                                           |
| `team_gid`   | string  |     ✅    | `"12345"`                        | Globally unique identifier for the team. Must be a numeric string (digits only).                                                                                                                            |
| `opt_fields` | array   |          | `["name","gid","resource_type"]` | 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. |
| `opt_pretty` | boolean |          | `true`                           | Provides “pretty” output.                                                                                                                                                                                   |

***

### `Asana Get Project Status`

Integration name: **ASANA\_GET\_PROJECT\_STATUS**

Tool to retrieve the full record for a single project status by its GID. Use when you need to get the details of a specific project status update.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example                  | Description                                        |
| -------------------- | ------- | :------: | ------------------------ | -------------------------------------------------- |
| `opt_fields`         | array   |          | `["gid","title","text"]` | Fields to include in the response.                 |
| `opt_pretty`         | boolean |          | —                        | Provides “pretty” output.                          |
| `project_status_gid` | string  |     ✅    | `"12345"`                | Globally unique identifier for the project status. |

***

### `Asana Get Project Status Updates`

Integration name: **ASANA\_GET\_PROJECT\_STATUS\_UPDATES**

Tool to get status updates for a specific project. Use when you need to retrieve the latest or historical status reports associated with an Asana project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------- | ------- | :------: | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`       | integer |          | `20`                     | Results per page. The number of items to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                                                                                                                                                               |
| `offset`      | string  |          | `"eyJ0eXAiOJiV...`"      | Offset token. An offset to paginate from. This can be retrieved from the 'next\_page' field in a previous response.                                                                                                                                                                                                                                                                                                                                                                          |
| `opt_fields`  | array   |          | `["name","gid","notes"]` | Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options. |
| `opt_pretty`  | boolean |          | —                        | Provides “pretty” output. Adds indentation and newlines to the response. This can be useful when debugging but increases the response size.                                                                                                                                                                                                                                                                                                                                                  |
| `project_gid` | string  |     ✅    | `"12345"`                | Globally unique identifier for the project.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

***

### `Asana Get Project Templates`

Integration name: **ASANA\_GET\_PROJECT\_TEMPLATES**

Tool to retrieve multiple project templates. Use when you need to list available project templates in a workspace or team.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                          | Description                                                                                                                                                                                                                                                                                                                     |
| --------------- | ------- | :------: | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | `20`                             | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                |
| `offset`        | string  |          | `"eyJ0eXAiOJiV...`"              | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request.                                                                                                                                                    |
| `team_gid`      | string  |          | `"14916"`                        | Globally unique identifier for the team. Recommended when working with organizations. REQUIRED: At least one of workspace\_gid or team\_gid must be provided. Accepts both 'team\_gid' and 'team' as parameter names.                                                                                                           |
| `opt_fields`    | array   |          | `["name","description","owner"]` | A comma-separated list of fields to include in the response. For example: name,description,owner,team,public                                                                                                                                                                                                                    |
| `workspace_gid` | string  |          | `"12345"`                        | Globally unique identifier for a regular workspace (not an organization). Only accepts workspace GIDs - organization GIDs will be rejected. For organizations, use team\_gid instead. REQUIRED: At least one of workspace\_gid or team\_gid must be provided. Accepts both 'workspace\_gid' and 'workspace' as parameter names. |

***

### `Asana Get Project Templates For Team`

Integration name: **ASANA\_GET\_PROJECT\_TEMPLATES\_FOR\_TEAM**

Tool to get a team's project templates in Asana. Use when you need to retrieve project templates associated with a specific team.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                  | Description                                                                                                                                                                                                                                                                                                                                                  |
| ------------ | ------- | :------: | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`      | integer |          | `50`                                                     | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                             |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"                                      | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
| `team_gid`   | string  |     ✅    | `"159874"`                                               | Globally unique identifier for the team.                                                                                                                                                                                                                                                                                                                     |
| `opt_fields` | array   |          | `["name","description","owner","team","public","color"]` | 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.                                                                                                                                                  |
| `opt_pretty` | boolean |          | `true`                                                   | Provides "pretty" output. Provides the response in a "pretty" 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.                                                                          |

***

### `Asana Get Reactions On Object`

Integration name: **ASANA\_GET\_REACTIONS\_ON\_OBJECT**

Tool to get reactions with a specific emoji base character on an object. Use when you need to retrieve user reactions (emoji responses) on a status update or story.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example              | Description                                                                                                                                                                                                                                                                       |
| ------------ | ------- | :------: | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `50`                 | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                  |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"  | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.                        |
| `target`     | string  |     ✅    | `"1212887201183176"` | Globally unique identifier for object to fetch reactions from. Must be a GID for a status update or story.                                                                                                                                                                        |
| `emoji_base` | string  |     ✅    | `"👍"`               | Only return reactions with this emoji base character.                                                                                                                                                                                                                             |
| `opt_pretty` | boolean |          | —                    | Provides 'pretty' output. Provides the response in a pretty 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. |

***

### `Asana Get Section`

Integration name: **ASANA\_GET\_SECTION**

Retrieve the full record for a single section by its GID. Use this when you need to get details about a specific section within a project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                                                                                                                                                                                                 |
| ------------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`  | array   |          | —       | 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. |
| `opt_pretty`  | boolean |          | —       | Provides “pretty” output.                                                                                                                                                                                   |
| `section_gid` | string  |     ✅    | —       | The globally unique identifier for the section.                                                                                                                                                             |

***

### `Asana Get Sections In Project`

Integration name: **ASANA\_GET\_SECTIONS\_IN\_PROJECT**

Returns compact records for all sections (used to group tasks) in a specified project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                    | Description                                                |
| ------------- | ------- | :------: | -------------------------- | ---------------------------------------------------------- |
| `limit`       | integer |          | `50`                       | Number of sections to return per page (1-100).             |
| `offset`      | string  |          | `"eyJ...example.token..."` | Token for pagination to retrieve the next page of results. |
| `project_gid` | string  |     ✅    | `"1210473471812630"`       | Globally unique identifier (GID) of the project.           |

***

### `Asana Get Status`

Integration name: **ASANA\_GET\_STATUS**

Tool to retrieve the full record for a single status update by its GID. Use when you need to get the details of a specific status update.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                                                                                                                                                                 | Description                                                                                                                                                                                                 |
| ------------------- | ------- | :------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`        | array   |          | `["author","author.name","created_at","created_by","created_by.name","html_text","modified_at","parent","parent.name","resource_subtype","status_type","text","title"]` | 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. |
| `opt_pretty`        | boolean |          | —                                                                                                                                                                       | Provides "pretty" output. Provides the response in a pretty format with proper line breaking and indentation.                                                                                               |
| `status_update_gid` | string  |     ✅    | `"321654"`                                                                                                                                                              | Globally unique identifier for the status update.                                                                                                                                                           |

***

### `Asana Get Status Updates`

Integration name: **ASANA\_GET\_STATUS\_UPDATES**

Retrieve status updates from an object. Use when you need to get the latest or historical status updates for a specific project, portfolio, or goal.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                         | Description                                                                                                      |
| ------------ | ------- | :------: | ------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `20`                            | The maximum number of items to return per page. The value must be between 1 and 100.                             |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"             | An offset token returned from a previous query that had a `next_page` property. This is used for pagination.     |
| `parent`     | string  |     ✅    | `"12345"`                       | Globally unique identifier (GID) of the object (project, portfolio, or goal) from which to fetch status updates. |
| `opt_fields` | array   |          | `["gid","title","status_type"]` | A comma-separated list of fields to include in the response. This allows customization of the returned data.     |

***

### `Asana Get Stories For Task`

Integration name: **ASANA\_GET\_STORIES\_FOR\_TASK**

Tool to get stories (comments, status updates, etc.) for a task. Use when you need to retrieve the history or discussion associated with a specific task.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                 | Description                                                               |
| ------------ | ------- | :------: | ----------------------- | ------------------------------------------------------------------------- |
| `limit`      | integer |          | `20`                    | Results per page. The number of results per page (between 1 and 100).     |
| `offset`     | string  |          | `"abcdefg"`             | Offset token for pagination.                                              |
| `task_gid`   | string  |     ✅    | `"12345"`               | The GID of the task to get stories from.                                  |
| `opt_fields` | array   |          | `["created_by","text"]` | A comma-separated list of optional properties to include in the response. |

***

### `Asana Get Story`

Integration name: **ASANA\_GET\_STORY**

Tool to retrieve a story. Use when you need to get the complete record for a single story.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                              | Description                                                  |
| ------------ | ------- | :------: | ------------------------------------ | ------------------------------------------------------------ |
| `story_gid`  | string  |     ✅    | `"12345"`                            | Globally unique identifier for the story.                    |
| `opt_fields` | array   |          | `["created_at","created_by","text"]` | A comma-separated list of fields to include in the response. |
| `opt_pretty` | boolean |          | —                                    | Provides "pretty" output.                                    |

***

### `Asana Get Tag`

Integration name: **ASANA\_GET\_TAG**

Tool to get a single tag by its globally unique identifier. Use when you need to retrieve detailed information about a specific tag.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                    | Description                                                      |
| ------------ | ------- | :------: | -------------------------- | ---------------------------------------------------------------- |
| `tag_gid`    | string  |     ✅    | `"12345"`                  | Globally unique identifier for the tag.                          |
| `opt_fields` | array   |          | `["name","notes","color"]` | A comma-separated list of properties to include in the response. |
| `opt_pretty` | boolean |          | —                          | If true, provides "pretty" (i.e., human-readable) JSON output.   |

***

### `Asana Get Tags`

Integration name: **ASANA\_GET\_TAGS**

Get multiple tags in a workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                  | Description                                                             |
| ------------ | ------- | :------: | ------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| `limit`      | integer |          | `20`                                                                     | Results per page.                                                       |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"                                                      | Offset token for pagination.                                            |
| `workspace`  | string  |          | `"12345"`                                                                | The GID of the workspace to filter tags on.                             |
| `opt_fields` | array   |          | `["color","created_at","followers","notes","permalink_url","workspace"]` | Comma-separated list of optional properties to include in the response. |

***

### `Asana Get Tags For Task`

Integration name: **ASANA\_GET\_TAGS\_FOR\_TASK**

Tool to get all tags associated with a specific task. Use when you need to retrieve tags for categorization, filtering, or understanding task organization.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                                                                                 | Description                                                                  |
| ------------ | ------- | :------: | --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| `limit`      | integer |          | `50`                                                                                                                                    | Results per page. The value must be between 1 and 100.                       |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"                                                                                                                     | Offset token for pagination. An offset to the next page returned by the API. |
| `task_gid`   | string  |     ✅    | `"321654"`                                                                                                                              | Globally unique identifier for the task.                                     |
| `opt_fields` | array   |          | `["color","created_at","followers","followers.name","name","notes","offset","path","permalink_url","uri","workspace","workspace.name"]` | A comma-separated list of properties to include in the response.             |
| `opt_pretty` | boolean |          | —                                                                                                                                       | If true, provides "pretty" (i.e., human-readable) JSON output.               |

***

### `Asana Get Tags For Workspace`

Integration name: **ASANA\_GET\_TAGS\_FOR\_WORKSPACE**

Tool to get all tags in a specific workspace. Use when you need to retrieve tags for categorizing tasks within a workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                                                                                           | Description                                                                                                                                                                                                 |
| --------------- | ------- | :------: | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | `50`                                                                                                              | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                            |
| `offset`        | string  |          | `"eyJ0eXAiOJiV...`"                                                                                               | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request.                                |
| `opt_fields`    | array   |          | `["color","created_at","followers","followers.name","name","notes","permalink_url","workspace","workspace.name"]` | 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. |
| `opt_pretty`    | boolean |          | —                                                                                                                 | Provides "pretty" output. Provides the response in a pretty format. In the case of JSON this means doing proper line breaking and indentation to make it readable.                                          |
| `workspace_gid` | string  |     ✅    | `"12345"`                                                                                                         | Globally unique identifier for the workspace or organization.                                                                                                                                               |

***

### `Asana Get Task Attachments`

Integration name: **ASANA\_GET\_TASK\_ATTACHMENTS**

Tool to get the list of attachments for a given task, project, or project\_brief. Use when you need to retrieve files attached to a specific Asana object.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                 | Description                                                                                                                                                                                                                               |
| ------------ | ------- | :------: | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `20`                                    | The number of results per page.                                                                                                                                                                                                           |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"                     | An offset token, used for pagination to retrieve the next page of results. If not provided or empty, the first page of results is returned.                                                                                               |
| `opt_fields` | array   |          | `["name","download_url","parent.name"]` | A comma-separated list of fields to include in the response for each attachment. Possible fields include: `created_at`, `download_url`, `host`, `name`, `parent`, `parent.name`, `permanent_url`, `resource_subtype`, `size`, `view_url`. |
| `parent_gid` | string  |     ✅    | `"1205766923323569"`                    | The GID of the task, project, or project\_brief to fetch attachments from.                                                                                                                                                                |

***

### `Asana Get Task Counts For Project`

Integration name: **ASANA\_GET\_TASK\_COUNTS\_FOR\_PROJECT**

Tool to get task count statistics for a project. Use when you need to retrieve the number of tasks, completed tasks, incomplete tasks, and milestone counts for a specific Asana project. Note that all fields are excluded by default - you must specify them in opt\_fields to get any data.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                                                                                                                              | Description                                                                                                                                                                                                                                                                                                                              |
| ------------- | ------- | :------: | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`  | array   |          | `["num_tasks","num_completed_tasks","num_incomplete_tasks","num_milestones","num_completed_milestones","num_incomplete_milestones"]` | Comma-separated list of fields to include in the response. Available fields: num\_tasks, num\_completed\_tasks, num\_incomplete\_tasks, num\_milestones, num\_completed\_milestones, num\_incomplete\_milestones. All fields are excluded by default, so you must opt in using this parameter to get any information from this endpoint. |
| `opt_pretty`  | boolean |          | —                                                                                                                                    | Provides "pretty" output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                                                                                                       |
| `project_gid` | string  |     ✅    | `"1331"`                                                                                                                             | Globally unique identifier for the project.                                                                                                                                                                                                                                                                                              |

***

### `Asana Get Tasks For Tag`

Integration name: **ASANA\_GET\_TASKS\_FOR\_TAG**

Tool to retrieve tasks associated with a specific Asana tag by tag GID. Use when you need to list all tasks that have been tagged with a particular label.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                         | Description                                                                                                                                                                                                                                                                                                                                                  |
| ------------ | ------- | :------: | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`      | integer |          | `50`                            | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                             |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"             | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
| `tag_gid`    | string  |     ✅    | `"1208891266930939"`            | Globally unique identifier for the tag.                                                                                                                                                                                                                                                                                                                      |
| `opt_fields` | array   |          | `["name","completed","due_on"]` | This endpoint returns a compact representation of a resource by default. To include optional properties, set this query parameter to a comma-separated list of the properties you wish to include (e.g., 'name', 'completed', 'due\_on', 'assignee').                                                                                                        |
| `opt_pretty` | boolean |          | —                               | Provides 'pretty' output. Provides the response in a 'pretty' 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.                                                                          |

***

### `Asana Get Tasks For User Task List`

Integration name: **ASANA\_GET\_TASKS\_FOR\_USER\_TASK\_LIST**

Tool to retrieve tasks from a user task list by user task list GID. Use when you need to list tasks assigned to a specific user's task list.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example                        | Description                                                                                                                                                                                                                                                                                                                                                  |
| -------------------- | ------- | :------: | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`              | integer |          | `50`                           | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                             |
| `offset`             | string  |          | `"eyJ0eXAiOJiV...`"            | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request. |
| `opt_fields`         | array   |          | `["name","assignee","due_on"]` | This endpoint returns a compact representation of a resource. To include additional properties, set this query parameter to a comma-separated list of the properties you wish to include.                                                                                                                                                                    |
| `opt_pretty`         | boolean |          | —                              | Provides 'pretty' output. Provides the response in a 'pretty' 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.                                                                          |
| `completed_since`    | string  |          | `"2012-02-22T02:06:58.158Z"`   | Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string (ISO 8601 format) or the keyword 'now'.                                                                                                                                                                                                 |
| `user_task_list_gid` | string  |     ✅    | `"1210124537178663"`           | Globally unique identifier (GID) of the user task list.                                                                                                                                                                                                                                                                                                      |

***

### `Asana Get Tasks From A Project`

Integration name: **ASANA\_GET\_TASKS\_FROM\_A\_PROJECT**

Retrieves tasks from a specified Asana project, allowing filtering by completion status and selection of optional fields for detailed responses.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                      | Description                                                                                                                                                                                                                          |
| ----------------- | ------- | :------: | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`           | integer |          | —                            | Maximum number of tasks to return per page. Defaults to 100 to enable pagination and avoid API errors on large projects.                                                                                                             |
| `offset`          | string  |          | —                            | Opaque pagination token from a previous response's 'next\_page.offset' field. Must be passed exactly as received without any modification or truncation. If omitted or empty, returns the first page. Tokens expire after some time. |
| `opt_fields`      | array   |          | `"assignee"`                 | Optional fields for a detailed task representation (e.g., 'assignee', 'due\_on'), as tasks are compact by default. Refer to Asana API docs for all field names.                                                                      |
| `opt_pretty`      | boolean |          | —                            | If true, returns human-readable JSON; useful for debugging but increases response size.                                                                                                                                              |
| `project_gid`     | string  |     ✅    | `"1202702190178032"`         | Globally unique identifier (GID) of the project.                                                                                                                                                                                     |
| `completed_since` | string  |          | `"2023-10-26T10:00:00.000Z"` | Filters tasks: returns incomplete tasks or those completed after the specified ISO 8601 date-time (e.g., '2023-10-26T10:00:00Z') or 'now'. If omitted or empty, no completion filter is applied.                                     |

***

### `Asana Get Tasks From Section`

Integration name: **ASANA\_GET\_TASKS\_FROM\_SECTION**

Tool to retrieve tasks that belong to a specific Asana section (column/header) by section GID. Use when you need to list tasks within a particular section, such as for agenda or carryover workflows. Board view only feature.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                        | Description                                                                                                                                                                                                                                      |
| ----------------- | ------- | :------: | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`           | integer |          | `50`                           | Maximum number of tasks to return per page (1-100).                                                                                                                                                                                              |
| `offset`          | string  |          | `"eyJ0eXAiOJiV...`"            | Opaque pagination token from a previous response's 'next\_page.offset' field. Must be passed exactly as received without any modification or truncation. If omitted or empty, returns the first page. Tokens expire after some time.             |
| `opt_fields`      | array   |          | `["assignee","due_on","name"]` | Optional fields for a detailed task representation (e.g., 'assignee', 'due\_on', 'completed\_at'). By default, tasks are returned in compact format. Use this to request specific fields. Refer to Asana API docs for all available field names. |
| `opt_pretty`      | boolean |          | —                              | If true, returns human-readable JSON; useful for debugging but increases response size.                                                                                                                                                          |
| `section_gid`     | string  |     ✅    | `"1210473471812630"`           | Globally unique identifier (GID) of the section.                                                                                                                                                                                                 |
| `completed_since` | string  |          | `"2023-10-26T10:00:00.000Z"`   | Filters tasks: returns incomplete tasks or those completed after the specified ISO 8601 date-time (e.g., '2023-10-26T10:00:00Z') or 'now'. Omit to retrieve all tasks in the section.                                                            |

***

### `Asana Get Task Subtasks`

Integration name: **ASANA\_GET\_TASK\_SUBTASKS**

Tool to retrieve multiple task subtasks from a workspace. Use when you need to list or find available task subtasks.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------ | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | —       | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                                                                                                                                                             |
| `offset`     | string  |          | —       | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.                                                                                                                                                                                                                                   |
| `task_gid`   | string  |     ✅    | —       | The globally unique identifier for the task.                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `opt_fields` | array   |          | —       | Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options. |

***

### `Asana Get Task Templates`

Integration name: **ASANA\_GET\_TASK\_TEMPLATES**

Tool to retrieve multiple task templates from a workspace. Use when you need to list or find available task templates.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example             | Description                                                                                             |
| --------------- | ------- | :------: | ------------------- | ------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | `20`                | The number of objects to return per page.                                                               |
| `offset`        | string  |          | `"abcdefg"`         | Offset token for pagination.                                                                            |
| `opt_fields`    | string  |          | `"name,created_at"` | Comma-separated list of fields to include in the response. For example: 'name,created\_at,created\_by'. |
| `project_gid`   | string  |          | `"1234567890"`      | Globally unique identifier for the project. One of project or workspace must be specified.              |
| `workspace_gid` | string  |          | `"12345"`           | Globally unique identifier for the workspace. One of project or workspace must be specified.            |

***

### `Asana Get Team`

Integration name: **ASANA\_GET\_TEAM**

Tool to retrieve details of a specific team by its GID. Use when you need to fetch information about a particular team in Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                                                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------ | ------- | :------: | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `team_gid`   | string  |     ✅    | `"159874"`                                                                                                  | Globally unique identifier for the team.                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `opt_fields` | array   |          | `["description","html_description","name","organization","organization.name","permalink_url","visibility"]` | Defines fields to return. Some requests return *compact* representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths. The id of included objects will always be returned, regardless of the field options. |
| `opt_pretty` | boolean |          | —                                                                                                           | Provides “pretty” output. 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.                                                                                                                                                                                                                                       |

***

### `Asana Get Team Membership`

Integration name: **ASANA\_GET\_TEAM\_MEMBERSHIP**

Tool to retrieve a complete team membership record by its GID. Use when you need to fetch details about a specific team membership in Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type    | Required | Example                                                                             | Description                                                                                                                                                                                                                             |
| --------------------- | ------- | :------: | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`          | array   |          | `["is_admin","is_guest","is_limited_access","team","team.name","user","user.name"]` | 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.                             |
| `opt_pretty`          | boolean |          | —                                                                                   | Provides "pretty" output. 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. |
| `team_membership_gid` | string  |     ✅    | `"724362"`                                                                          | Globally unique identifier for the team membership.                                                                                                                                                                                     |

***

### `Asana Get Team Memberships`

Integration name: **ASANA\_GET\_TEAM\_MEMBERSHIPS**

Tool to retrieve compact team membership records. Use when you need to list members of a team, teams a user belongs to, or all team memberships in a workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                      | Description                             |
| ------------ | ------- | :------: | -------------------------------------------- | --------------------------------------- |
| `team`       | string  |          | —                                            | The team to filter memberships to.      |
| `user`       | string  |          | —                                            | A user gid to filter memberships to.    |
| `limit`      | integer |          | —                                            | Results per page.                       |
| `offset`     | string  |          | —                                            | Offset token.                           |
| `workspace`  | string  |          | —                                            | The workspace to filter memberships to. |
| `opt_fields` | array   |          | `["gid","user.name","team.name","is_guest"]` | Defines fields to return.               |
| `opt_pretty` | boolean |          | —                                            | Adds indentation to JSON response.      |

***

### `Asana Get Team Memberships For Team`

Integration name: **ASANA\_GET\_TEAM\_MEMBERSHIPS\_FOR\_TEAM**

Tool to get memberships from a specific team. Use when you need to retrieve the list of users who are members of a particular team, including their membership details such as admin status and guest status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                             | Description                                                                                                                                                                                                                                                |
| ------------ | ------- | :------: | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | —                                                                                   | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                           |
| `offset`     | string  |          | —                                                                                   | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. |
| `team_gid`   | string  |     ✅    | `"159874"`                                                                          | Globally unique identifier for the team.                                                                                                                                                                                                                   |
| `opt_fields` | array   |          | `["is_admin","is_guest","is_limited_access","team","team.name","user","user.name"]` | 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.                                                |
| `opt_pretty` | boolean |          | —                                                                                   | Provides "pretty" output. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                                                                   |

***

### `Asana Get Team Memberships For User`

Integration name: **ASANA\_GET\_TEAM\_MEMBERSHIPS\_FOR\_USER**

Tool to get team memberships for a specific user. Use when you need to retrieve all teams that a user belongs to within a workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                               | Description                                                                                                                                                                                                                                                                       |
| ------------ | ------- | :------: | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `50`                                                                  | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                  |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"                                                   | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.                        |
| `user_gid`   | string  |     ✅    | `"me"`                                                                | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                                                                                                  |
| `workspace`  | string  |     ✅    | `"31326"`                                                             | Globally unique identifier for the workspace.                                                                                                                                                                                                                                     |
| `opt_fields` | array   |          | `["is_admin","is_guest","is_limited_access","team.name","user.name"]` | 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.                                                                       |
| `opt_pretty` | boolean |          | —                                                                     | Provides "pretty" output. Provides the response in a pretty 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. |

***

### `Asana Get Teams For User`

Integration name: **ASANA\_GET\_TEAMS\_FOR\_USER**

Tool to get teams for a specific user in an organization. Returns the team records for all teams in the organization or workspace to which the given user is assigned.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example                                                 | Description                                                                                                                                                                                                                                                |
| -------------- | ------- | :------: | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`        | integer |          | `50`                                                    | Results per page. The value must be between 1 and 100.                                                                                                                                                                                                     |
| `offset`       | string  |          | `"eyJ0eXAiOJiV...`"                                     | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. |
| `user_gid`     | string  |     ✅    | `"me"`                                                  | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                                                                           |
| `opt_fields`   | array   |          | `["name","description","organization","permalink_url"]` | 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.                                                |
| `opt_pretty`   | boolean |          | —                                                       | Provides "pretty" output. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                                                                   |
| `organization` | string  |     ✅    | `"1331"`                                                | The workspace or organization to filter teams on.                                                                                                                                                                                                          |

***

### `Asana Get Teams In Workspace`

Integration name: **ASANA\_GET\_TEAMS\_IN\_WORKSPACE**

Returns the compact records for all teams in the workspace visible to the authorized user.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example              | Description                                                                                                                                                                  |
| --------------- | ------- | :------: | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | `50`                 | Results per page. The value must be between 1 and 100.                                                                                                                       |
| `offset`        | string  |          | `"eyJ0eXAiO...`"     | Offset token from a previous API response for pagination to retrieve the next page of results. If an offset is not passed in, the API will return the first page of results. |
| `workspace_gid` | string  |     ✅    | `"1205766922013215"` | The Global ID (GID) of the workspace to get teams from.                                                                                                                      |

***

### `Asana Get Time Period`

Integration name: **ASANA\_GET\_TIME\_PERIOD**

Tool to retrieve the full record for a single time period by its GID. Use when you need to fetch detailed information about a specific time period, including its start/end dates, display name, and parent period.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                                                                                                                          | Description                                                                                                                                |
| ----------------- | ------- | :------: | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `opt_fields`      | array   |          | `["display_name","end_on","parent","parent.display_name","parent.end_on","parent.period","parent.start_on","period","start_on"]` | Comma-separated list of fields to include in the response.                                                                                 |
| `opt_pretty`      | boolean |          | —                                                                                                                                | Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. |
| `time_period_gid` | string  |     ✅    | `"917392"`                                                                                                                       | Globally unique identifier for the time period.                                                                                            |

***

### `Asana Get Time Periods`

Integration name: **ASANA\_GET\_TIME\_PERIODS**

Tool to retrieve compact or full representations of time periods. Use this when you need to fetch information about specific time periods, such as their start and end dates, display names, and parent periods.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                                                        | Description                                                  |
| --------------- | ------- | :------: | ------------------------------------------------------------------------------ | ------------------------------------------------------------ |
| `limit`         | integer |          | —                                                                              | Results per page.                                            |
| `end_on`        | string  |          | —                                                                              | The last day of the time period, YYYY-MM-DD.                 |
| `offset`        | string  |          | —                                                                              | Offset token for pagination.                                 |
| `start_on`      | string  |          | —                                                                              | The first day of the time period, YYYY-MM-DD.                |
| `opt_fields`    | array   |          | `["gid","resource_type","start_on","end_on","period","display_name","parent"]` | A comma-separated list of fields to include in the response. |
| `opt_pretty`    | boolean |          | —                                                                              | Provides the response in "pretty" output.                    |
| `workspace_gid` | string  |     ✅    | `"12345"`                                                                      | Globally unique identifier for the workspace.                |

***

### `Asana Get Time Tracking Entries`

Integration name: **ASANA\_GET\_TIME\_TRACKING\_ENTRIES**

Tool to get multiple time tracking entries across workspace, tasks, or projects. Use when you need to retrieve time tracking information for filtering by workspace, task, portfolio, user, or date range.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                   | Type    | Required | Example                                                                                                                           | Description                                                                                                                                                                                                                                                                                                                                         |
| --------------------------- | ------- | :------: | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `task`                      | string  |          | `"12345"`                                                                                                                         | Globally unique identifier for the task to filter time tracking entries by.                                                                                                                                                                                                                                                                         |
| `user`                      | string  |          | `"12345"`                                                                                                                         | Globally unique identifier for the user to filter time tracking entries by.                                                                                                                                                                                                                                                                         |
| `limit`                     | integer |          | `50`                                                                                                                              | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                    |
| `offset`                    | string  |          | `"eyJ0eXAiOJiV...`"                                                                                                               | Offset token to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. *Note: You can only pass in an offset that was returned to you via a previously paginated request.* |
| `portfolio`                 | string  |          | `"12345"`                                                                                                                         | Globally unique identifier for the portfolio to filter time tracking entries by.                                                                                                                                                                                                                                                                    |
| `workspace`                 | string  |          | `"1205766922013215"`                                                                                                              | Globally unique identifier for the workspace. At least one of entered\_on\_start\_date or entered\_on\_end\_date must be provided when filtering by workspace.                                                                                                                                                                                      |
| `opt_fields`                | array   |          | `["attributable_to","attributable_to.name","created_by","created_by.name","duration_minutes","entered_on","offset","path","uri"]` | 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.                                                                                                                                         |
| `opt_pretty`                | boolean |          | `true`                                                                                                                            | Provides "pretty" output. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                                                                                                                                                            |
| `attributable_to`           | string  |          | `"12345"`                                                                                                                         | Globally unique identifier for the project the time tracking entries are attributed to.                                                                                                                                                                                                                                                             |
| `entered_on_end_date`       | string  |          | `"2025-12-31"`                                                                                                                    | The end date for filtering time tracking entries by when they were entered.                                                                                                                                                                                                                                                                         |
| `entered_on_start_date`     | string  |          | `"2025-01-01"`                                                                                                                    | The start date for filtering time tracking entries by when they were entered.                                                                                                                                                                                                                                                                       |
| `timesheet_approval_status` | string  |          | `"12345"`                                                                                                                         | Globally unique identifier for the timesheet approval status to filter time tracking entries by.                                                                                                                                                                                                                                                    |

***

### `Asana Get Time Tracking Entries For Task`

Integration name: **ASANA\_GET\_TIME\_TRACKING\_ENTRIES\_FOR\_TASK**

Tool to get time tracking entries for a task. Use when you need to retrieve time tracking information recorded on a specific task.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                                                                           | Description                                                                                                                                                                                                                                                                                                                                                    |
| ------------ | ------- | :------: | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | —                                                                                                                                 | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                               |
| `offset`     | string  |          | —                                                                                                                                 | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. *Note: You can only pass in an offset that was returned to you via a previously paginated request.* |
| `task_gid`   | string  |     ✅    | `"321654"`                                                                                                                        | The task to operate on.                                                                                                                                                                                                                                                                                                                                        |
| `opt_fields` | array   |          | `["attributable_to","attributable_to.name","created_by","created_by.name","duration_minutes","entered_on","offset","path","uri"]` | 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.                                                                                                                                                    |
| `opt_pretty` | boolean |          | —                                                                                                                                 | Provides "pretty" output. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                                                                                                                                                                       |

***

### `Asana Get Typeahead Objects`

Integration name: **ASANA\_GET\_TYPEAHEAD\_OBJECTS**

Tool to retrieve objects in a workspace via a typeahead search algorithm. Use when you need to quickly find objects like tasks, projects, users, etc., based on a search string. This is useful for implementing auto-completion features.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example            | Description                                                                                                                                                                                                 |
| --------------- | ------- | :------: | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `count`         | integer |          | `10`               | The number of results to return. The default is 20 if this parameter is omitted, with a minimum of 1 and a maximum of 100.                                                                                  |
| `query`         | string  |          | `"John Doe"`       | The string that will be used to search for relevant objects. If an empty string is passed in, the API will return results.                                                                                  |
| `opt_fields`    | array   |          | `["name","email"]` | 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. |
| `opt_pretty`    | boolean |          | `true`             | Provides “pretty” output. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                    |
| `resource_type` | string  |          | `"user"`           | The type of values the typeahead should return.                                                                                                                                                             |
| `workspace_gid` | string  |     ✅    | `"12345"`          | Globally unique identifier for the workspace or organization.                                                                                                                                               |

***

### `Asana Get User`

Integration name: **ASANA\_GET\_USER**

Get a user by their ID.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example   | Description                                                                                                                                                                                                 |
| ------------ | ------- | :------: | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_gid`   | string  |     ✅    | `"12345"` | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                            |
| `opt_fields` | array   |          | —         | 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. |
| `opt_pretty` | boolean |          | —         | Provides “pretty” output.                                                                                                                                                                                   |

***

### `Asana Get User For Workspace`

Integration name: **ASANA\_GET\_USER\_FOR\_WORKSPACE**

Tool to get a user in a workspace or organization by their GID. Use when you need to retrieve details about a specific user within a workspace context.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example   | Description                                                                                                                                                                                                 |
| --------------- | ------- | :------: | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_gid`      | string  |     ✅    | `"me"`    | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                            |
| `opt_fields`    | array   |          | —         | 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. |
| `opt_pretty`    | boolean |          | —         | Provides "pretty" output. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                    |
| `workspace_gid` | string  |     ✅    | `"12345"` | Globally unique identifier for the workspace or organization.                                                                                                                                               |

***

### `Asana Get Users For Team`

Integration name: **ASANA\_GET\_USERS\_FOR\_TEAM**

Get users in a team.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example            | Description                                                                                                                                                                                                          |
| ------------ | ------- | :------: | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | —                  | Results per page. The maximum is 2000.                                                                                                                                                                               |
| `offset`     | string  |          | —                  | Offset token.                                                                                                                                                                                                        |
| `team_gid`   | string  |     ✅    | `"12345"`          | Globally unique identifier for the team.                                                                                                                                                                             |
| `opt_fields` | array   |          | `["name","email"]` | This endpoint returns a compact 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. |
| `opt_pretty` | boolean |          | —                  | Provides “pretty” output.                                                                                                                                                                                            |

***

### `Asana Get Users For Workspace`

Integration name: **ASANA\_GET\_USERS\_FOR\_WORKSPACE**

Get users in a workspace or organization.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example             | Description                                                                                                                                                                                                 |
| --------------- | ------- | :------: | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | —                   | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                            |
| `offset`        | string  |          | —                   | Offset token for pagination requests.                                                                                                                                                                       |
| `opt_fields`    | array   |          | `["email","photo"]` | 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. |
| `opt_pretty`    | boolean |          | —                   | Provides “pretty” output.                                                                                                                                                                                   |
| `workspace_gid` | string  |     ✅    | `"12345"`           | Globally unique identifier for the workspace or organization.                                                                                                                                               |

***

### `Asana Get User Task List`

Integration name: **ASANA\_GET\_USER\_TASK\_LIST**

Tool to get a single user task list by its globally unique identifier. Use when you need to retrieve information about a specific user's My Tasks list.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example                        | Description                                                                                                                                                                                                 |
| -------------------- | ------- | :------: | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`         | array   |          | `["name","owner","workspace"]` | 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. |
| `opt_pretty`         | boolean |          | —                              | Provides "pretty" output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging.                          |
| `user_task_list_gid` | string  |     ✅    | `"12345"`                      | Globally unique identifier for the user task list.                                                                                                                                                          |

***

### `Asana Get Webhooks`

Integration name: **ASANA\_GET\_WEBHOOKS**

Tool to retrieve multiple webhooks in a workspace. Use when you need to list all webhooks for a workspace or filter webhooks by a specific resource.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                        | Description                                                                                                                                                                                                 |
| ------------ | ------- | :------: | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `50`                                                                           | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                            |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"                                                            | Offset token for pagination. An offset to the next page returned by the API.                                                                                                                                |
| `resource`   | string  |          | `"51648"`                                                                      | Only return webhooks for the given resource.                                                                                                                                                                |
| `workspace`  | string  |     ✅    | `"1331"`                                                                       | The workspace to query for webhooks in.                                                                                                                                                                     |
| `opt_fields` | array   |          | `["active","created_at","filters","last_success_at","target","resource.name"]` | 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. |
| `opt_pretty` | boolean |          | —                                                                              | Provides "pretty" output.                                                                                                                                                                                   |

***

### `Asana Get Workspace`

Integration name: **ASANA\_GET\_WORKSPACE**

Tool to retrieve details of a specific workspace by its GID. Use when you need to get information about a particular Asana workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                    | Description                                                                                                                                                             |
| --------------- | ------- | :------: | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`    | array   |          | `["name","email_domains"]` | This results in a compact response, suitable for data-transfer sensitive applications. Valid values are: gid, name, resource\_type, email\_domains, is\_organization.   |
| `opt_pretty`    | boolean |          | —                          | Provides “pretty” output. Formatting dates and times as human-readable strings, numbers as strings, and including newlines and indentation. The default value is false. |
| `workspace_gid` | string  |     ✅    | `"12345"`                  | The globally unique identifier of the workspace.                                                                                                                        |

***

### `Asana Get Workspace Membership`

Integration name: **ASANA\_GET\_WORKSPACE\_MEMBERSHIP**

Tool to retrieve a specific workspace membership by its GID. Use when you need to get details about a user's membership in a workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                  | Type    | Required | Example                                                                                                                                                                                                                                                                       | Description                                                                                                                                                                                                 |
| -------------------------- | ------- | :------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `opt_fields`               | array   |          | `["created_at","is_active","is_admin","is_guest","is_view_only","user","user.name","user_task_list","user_task_list.name","user_task_list.owner","user_task_list.workspace","vacation_dates","vacation_dates.end_on","vacation_dates.start_on","workspace","workspace.name"]` | 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. |
| `opt_pretty`               | boolean |          | —                                                                                                                                                                                                                                                                             | Provides "pretty" output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging.                          |
| `workspace_membership_gid` | string  |     ✅    | `"12345"`                                                                                                                                                                                                                                                                     | Globally unique identifier for the workspace membership.                                                                                                                                                    |

***

### `Asana Get Workspace Memberships`

Integration name: **ASANA\_GET\_WORKSPACE\_MEMBERSHIPS**

Tool to retrieve the workspace memberships for a specific workspace. Use when you need to list members of a workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| --------------- | ------- | :------: | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`          | string  |          | `"me"`                                       | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                                                                                                                                                                                                                                                                                                  |
| `limit`         | integer |          | `20`                                         | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                                                                                                                                                                                                                                                  |
| `offset`        | string  |          | `"eyJ0eXAiOJiV...`"                          | Offset token.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `opt_fields`    | array   |          | `["user.name","workspace.name","is_active"]` | Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should return for each object. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options. |
| `workspace_gid` | string  |     ✅    | `"12345"`                                    | Globally unique identifier for the workspace.                                                                                                                                                                                                                                                                                                                                                                                                                                     |

***

### `Asana Get Workspace Memberships For User`

Integration name: **ASANA\_GET\_WORKSPACE\_MEMBERSHIPS\_FOR\_USER**

Tool to retrieve workspace memberships for a specific user. Use when you need to list all workspaces a user is a member of.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                                                                                                                | Description                                                                                                                                                                                                                                                |
| ------------ | ------- | :------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `50`                                                                                                                                                                   | Results per page. The number of objects to return per page. The value must be between 1 and 100.                                                                                                                                                           |
| `offset`     | string  |          | `"eyJ0eXAiOJiV...`"                                                                                                                                                    | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. |
| `user_gid`   | string  |     ✅    | `"me"`                                                                                                                                                                 | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                                                                           |
| `opt_fields` | array   |          | `["created_at","is_active","is_admin","is_guest","is_view_only","user.name","workspace.name","user_task_list.name","vacation_dates.start_on","vacation_dates.end_on"]` | 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.                                                |
| `opt_pretty` | boolean |          | —                                                                                                                                                                      | Provides "pretty" output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                         |

***

### `Asana Get Workspace Projects`

Integration name: **ASANA\_GET\_WORKSPACE\_PROJECTS**

Tool to retrieve the projects associated with a specific workspace. Use when you need to list all projects within a given Asana workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example             | Description                                                                                                                                                                            |
| --------------- | ------- | :------: | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | `20`                | Number of objects to return per page. For workspaces with many projects, this parameter is required to avoid pagination errors. Use the offset parameter to retrieve additional pages. |
| `offset`        | string  |          | `"eyJ0eXAiOJiV...`" | Offset token for pagination.                                                                                                                                                           |
| `opt_expand`    | array   |          | `["owner","team"]`  | Fields to expand in the response.                                                                                                                                                      |
| `opt_fields`    | array   |          | `["name","gid"]`    | Fields to include in the response.                                                                                                                                                     |
| `workspace_gid` | string  |     ✅    | `"12345"`           | Globally unique identifier for the workspace.                                                                                                                                          |

***

### `Asana Insert Enum Option For Custom Field`

Integration name: **ASANA\_INSERT\_ENUM\_OPTION\_FOR\_CUSTOM\_FIELD**

Tool to reorder an existing enum option within a custom field by moving it before or after another specified enum option. Use when you need to change the order/position of options in an enum or multi\_enum custom field. Note: To create new enum options, use 'Create Enum Option for Custom Field' action instead.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                      | Description                                                                                                                                                                                                 |
| ------------------ | ------- | :------: | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`             | object  |     ✅    | —                            | The data for the enum option to be inserted or reordered.                                                                                                                                                   |
| `opt_fields`       | array   |          | `["name","color","enabled"]` | 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. |
| `opt_pretty`       | boolean |          | —                            | Provides “pretty” output.                                                                                                                                                                                   |
| `custom_field_gid` | string  |     ✅    | `"12345"`                    | Globally unique identifier for the custom field.                                                                                                                                                            |

***

### `Asana Insert Section For Project`

Integration name: **ASANA\_INSERT\_SECTION\_FOR\_PROJECT**

Tool to move or reorder an existing section within a project by repositioning it before or after another section. Use when you need to change the position/order of sections in a project. Note: This action moves existing sections only. To create new sections, use 'Create Section in Project' action instead.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example              | Description                                                                                                                                                                        |
| ------------- | ------- | :------: | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`        | object  |     ✅    | —                    | The data specifying which section to move and where to position it.                                                                                                                |
| `opt_pretty`  | boolean |          | —                    | Provides "pretty" output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
| `project_gid` | string  |     ✅    | `"1210124791807961"` | Globally unique identifier for the project.                                                                                                                                        |

***

### `Asana Instantiate Project Template`

Integration name: **ASANA\_INSTANTIATE\_PROJECT\_TEMPLATE**

Instantiate (create) a real Asana project from a project template, returning the async job record. Use when you need to create a new project from a template with specific date and role assignments.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                                                               | Description                                                                                                                               |
| ---------------------- | ------- | :------: | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `name`                 | string  |     ✅    | `"Q1 Marketing Campaign"`                                             | The name for the new project that will be created from the template.                                                                      |
| `team`                 | string  |          | `"67890"`                                                             | Globally unique identifier for the team that the new project will belong to. Required if the template is a team template.                 |
| `is_strict`            | boolean |          | —                                                                     | If true, requires all date and role variables from the template to be provided. If false or omitted, missing variables will use defaults. |
| `opt_fields`           | array   |          | `["gid","status","new_project","new_project_template"]`               | Optional fields to include in the response. Common values: gid, status, new\_project, new\_project\_template.                             |
| `opt_pretty`           | boolean |          | —                                                                     | If true, returns human-readable JSON response (for debugging only due to size/processing impact).                                         |
| `privacy_setting`      | string  |          | `"public_to_workspace"`                                               | Privacy setting for the new project. If not specified, inherits from template or team settings.                                           |
| `requested_dates`      | array   |          | `[{"gid":"1","value":"2024-12-31"},{"gid":"2","value":"2025-01-15"}]` | Array of date variable assignments. Required if the template includes date variables and is\_strict is true.                              |
| `requested_roles`      | array   |          | `[{"gid":"role_gid_123","value":"user_gid_456"}]`                     | Array of role assignments mapping template roles to specific users.                                                                       |
| `project_template_gid` | string  |     ✅    | `"12345"`                                                             | Globally unique identifier for the project template to instantiate.                                                                       |

***

### `Asana Reject Access Request`

Integration name: **ASANA\_REJECT\_ACCESS\_REQUEST**

Tool to reject an access request. Use when you need to deny a user's request for access to a project or resource.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type   | Required | Example   | Description                                                                            |
| -------------------- | ------ | :------: | --------- | -------------------------------------------------------------------------------------- |
| `access_request_gid` | string |     ✅    | `"12345"` | Globally unique identifier for the access request to reject. Must be a numeric string. |

***

### `Asana Remove Follower From Task`

Integration name: **ASANA\_REMOVE\_FOLLOWER\_FROM\_TASK**

Tool to remove one or more followers from a task. Use when you need to update the list of users following a specific task.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example           | Description                                   |
| ----------- | ------ | :------: | ----------------- | --------------------------------------------- |
| `task_gid`  | string |     ✅    | `"12345"`         | The globally unique identifier for the task.  |
| `followers` | array  |     ✅    | `["1111","2222"]` | An array of user GIDs to remove as followers. |

***

### `Asana Remove Followers For Project`

Integration name: **ASANA\_REMOVE\_FOLLOWERS\_FOR\_PROJECT**

Tool to remove followers from a project in Asana. Use when you need to remove one or more users as followers from a specific project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                                         | Description                                                                                                                                                                                                                                                                       |
| ------------- | ------- | :------: | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `followers`   | string  |     ✅    | `"521621,621373"`                               | A comma-separated string of user identifiers. These can be the string "me", an email, or the gid of a user. For example: "521621,621373" or "me,<user@example.com>".                                                                                                              |
| `opt_fields`  | array   |          | `["name","notes","followers","followers.name"]` | 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.                                                                       |
| `opt_pretty`  | boolean |          | —                                               | Provides "pretty" output. Provides the response in a pretty 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. |
| `project_gid` | string  |     ✅    | `"1210124791807961"`                            | Globally unique identifier for the project.                                                                                                                                                                                                                                       |

***

### `Asana Remove Item From Portfolio`

Integration name: **ASANA\_REMOVE\_ITEM\_FROM\_PORTFOLIO**

Tool to remove an item (e.g., a project) from an Asana portfolio. Use to undo/cleanup portfolio membership, support moves between portfolios, or enforce portfolio hygiene.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example      | Description                                                                                                                                                                                                                                  |
| --------------- | ------- | :------: | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `item`          | string  |     ✅    | `"1331"`     | The globally unique identifier (GID) of the item (project or portfolio) to remove from the portfolio.                                                                                                                                        |
| `opt_fields`    | string  |          | `"name,gid"` | Comma-separated list of fields to include in the response. Limited utility for this endpoint as it returns an empty data block.                                                                                                              |
| `opt_pretty`    | boolean |          | —            | Provides 'pretty' output. Provides the response in a pretty format with proper line breaking and indentation for readability. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
| `portfolio_gid` | string  |     ✅    | `"12345"`    | The globally unique identifier for the portfolio.                                                                                                                                                                                            |

***

### `Asana Remove Members For Project`

Integration name: **ASANA\_REMOVE\_MEMBERS\_FOR\_PROJECT**

Tool to remove users from a project in Asana. Use this tool when you need to remove one or more users as members from a specific project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                      | Description                                                                                                                                                                                                 |
| ------------- | ------- | :------: | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `members`     | string  |     ✅    | `"521621,621373"`            | A comma-separated string of user identifiers. These can be the string "me", an email, or the gid of a user.                                                                                                 |
| `opt_fields`  | array   |          | `["name","members","owner"]` | 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. |
| `opt_pretty`  | boolean |          | —                            | Provides "pretty" output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging.                          |
| `project_gid` | string  |     ✅    | `"1331"`                     | Globally unique identifier for the project.                                                                                                                                                                 |

***

### `Asana Remove Project From Task`

Integration name: **ASANA\_REMOVE\_PROJECT\_FROM\_TASK**

Tool to remove a project from a task in Asana. Use this when you need to disassociate a task from a specific project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example    | Description                                                                                                                                                                        |
| ------------ | ------- | :------: | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `project`    | string  |     ✅    | `"13579"`  | The project to remove the task from.                                                                                                                                               |
| `task_gid`   | string  |     ✅    | `"321654"` | The task to operate on.                                                                                                                                                            |
| `opt_pretty` | boolean |          | —          | Provides "pretty" output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging. |

***

### `Asana Remove Tag From Task`

Integration name: **ASANA\_REMOVE\_TAG\_FROM\_TASK**

Tool to remove an existing tag from a task in Asana. Use this tool when you need to detach a tag from a specific task for cleanup or retagging automation.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                          | Description                                                                                                                                                                                                 |
| ------------ | ------- | :------: | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tag`        | string  |     ✅    | `"13579"`                        | The globally unique identifier for the tag to remove from the task.                                                                                                                                         |
| `task_gid`   | string  |     ✅    | `"1202599807151278"`             | The globally unique identifier for the task.                                                                                                                                                                |
| `opt_fields` | array   |          | `["gid","name","resource_type"]` | 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. |
| `opt_pretty` | boolean |          | —                                | Provides "pretty" output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging.                          |

***

### `Asana Remove User For Team`

Integration name: **ASANA\_REMOVE\_USER\_FOR\_TEAM**

Tool to remove a user from a team. Use when you need to revoke team membership for a specific user.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example    | Description                                                                                                                                                                        |
| ------------ | ------- | :------: | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`       | string  |     ✅    | `"12345"`  | A string identifying a user. This can either be the string 'me', an email, or the gid of a user.                                                                                   |
| `team_gid`   | string  |     ✅    | `"159874"` | Globally unique identifier for the team.                                                                                                                                           |
| `opt_pretty` | boolean |          | —          | Provides 'pretty' output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging. |

***

### `Asana Remove User For Workspace`

Integration name: **ASANA\_REMOVE\_USER\_FOR\_WORKSPACE**

Tool to remove a user from a workspace or organization. Use when you need to revoke a user's access to a specific workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example   | Description                                                                                                                                                                        |
| --------------- | ------- | :------: | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`          | string  |     ✅    | `"12345"` | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                   |
| `opt_pretty`    | boolean |          | —         | Provides "pretty" output. Provides the response in a pretty format. This will take extra time and increase the response size so it is advisable only to use this during debugging. |
| `workspace_gid` | string  |     ✅    | `"12345"` | Globally unique identifier for the workspace or organization.                                                                                                                      |

***

### `Asana Search Tasks In Workspace`

Integration name: **ASANA\_SEARCH\_TASKS\_IN\_WORKSPACE**

Tool to search tasks across a workspace with advanced filters. Use when performing complex queries such as overdue tasks, by project or custom field, for reporting or automation.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                    | Type    | Required | Example                                   | Description                                                                                                                                                                                                                                          |
| ---------------------------- | ------- | :------: | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `text`                       | string  |          | `"meeting"`                               | Search for tasks containing this text in name or notes. At least one search filter must be provided.                                                                                                                                                 |
| `limit`                      | integer |          | `"50"`                                    | Maximum number of results to return (1-100).                                                                                                                                                                                                         |
| `opt_fields`                 | array   |          | `["name","due_on","assignee"]`            | Additional fields to include in each task object; see Asana API docs for available fields.                                                                                                                                                           |
| `opt_pretty`                 | boolean |          | `true`                                    | Pretty-print the JSON response with indentation (useful for debugging).                                                                                                                                                                              |
| `assignee_any`               | array   |          | `["me"]`                                  | Return tasks assigned to any of these user GIDs; use 'me' for current user or 'null' for unassigned tasks. At least one search filter must be provided.                                                                                              |
| `projects_any`               | array   |          | `["1205766922013215","1205766922013216"]` | Return tasks in any of these project GIDs. Must contain valid numeric Asana project identifiers (e.g., '1205766922013215'). At least one search filter (projects\_any, assignee\_any, resource\_subtype, or text) must be provided.                  |
| `workspace_gid`              | string  |     ✅    | `"1205766922013215"`                      | Numeric GID of the workspace to search. Must be a valid numeric workspace identifier (e.g., '1205766922013215'). Note: Unlike assignee\_any, 'me' is not a valid value for workspace\_gid - use a numeric GID obtained from the workspaces endpoint. |
| `resource_subtype`           | string  |          | `"default_task"`                          | Filter by task subtype: 'default\_task' for regular tasks, 'milestone' for milestones. At least one search filter must be provided.                                                                                                                  |
| `composio_execution_message` | string  |          | —                                         | Message explaining any automatic modifications made to the request.                                                                                                                                                                                  |

***

### `Asana Set Parent For Task`

Integration name: **ASANA\_SET\_PARENT\_FOR\_TASK**

Tool to set the parent of a task in Asana. Use when you need to make a task a subtask of another task or remove the parent relationship.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                      | Description                                                                                                                                                                                                            |
| --------------- | ------- | :------: | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `parent`        | string  |     ✅    | `"1213187208675417"`                         | The GID of the new parent task, or 'null' to remove the parent. Setting a parent makes this task a subtask of the parent.                                                                                              |
| `task_gid`      | string  |     ✅    | `"1213245048982427"`                         | The globally unique identifier (GID) of the task to set the parent for.                                                                                                                                                |
| `opt_fields`    | string  |          | `"name,parent,parent.name,resource_subtype"` | Comma-separated list of fields to include in the response. By default, the response returns a compact representation of the task. Use this to retrieve additional fields such as 'name', 'parent', 'parent.name', etc. |
| `opt_pretty`    | boolean |          | —                                            | Provides 'pretty' output with 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.                 |
| `insert_after`  | string  |          | `"124816"`                                   | A subtask GID of the parent to insert the task after, or 'null' to insert at the beginning of the subtask list. If not provided, the task will be inserted at an appropriate position.                                 |
| `insert_before` | string  |          | `"124816"`                                   | A subtask GID of the parent to insert the task before, or 'null' to insert at the end of the subtask list. If not provided, the task will be inserted at an appropriate position.                                      |

***

### `Asana Submit Parallel Requests`

Integration name: **ASANA\_SUBMIT\_PARALLEL\_REQUESTS**

Tool to submit multiple Asana API requests in parallel using the Batch API. Use when you need to perform several operations efficiently, such as fetching multiple tasks or creating multiple subtasks at once.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example | Description                                               |
| --------- | ------ | :------: | ------- | --------------------------------------------------------- |
| `data`    | object |     ✅    | —       | Contains the list of actions to be performed in parallel. |

***

### `Asana Update Allocation`

Integration name: **ASANA\_UPDATE\_ALLOCATION**

Tool to update an existing allocation by its ID. Use this when you need to modify details like the start date, end date, effort, or assignee for an allocation.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example | Description                                                  |
| ---------------- | ------- | :------: | ------- | ------------------------------------------------------------ |
| `data`           | object  |     ✅    | —       | The data to update the allocation with.                      |
| `opt_fields`     | array   |          | —       | A comma-separated list of fields to include in the response. |
| `opt_pretty`     | boolean |          | —       | If true, the response will be in a human-readable format.    |
| `allocation_gid` | string  |     ✅    | —       | Globally unique identifier for the allocation to be updated. |

***

### `Asana Update A Task`

Integration name: **ASANA\_UPDATE\_A\_TASK**

Updates attributes of an existing Asana task identified by its task\_gid.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                        | Description                                                                                                                                                                                                                                                                                        |
| ------------ | ------- | :------: | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`       | object  |     ✅    | —                              | An object containing the fields of the task to update.                                                                                                                                                                                                                                             |
| `task_gid`   | string  |     ✅    | `"123456789012345"`            | The GID of the task to update.                                                                                                                                                                                                                                                                     |
| `opt_fields` | array   |          | `["name","assignee","due_on"]` | Array of optional properties to include in the response object. By default, a compact representation of the task is returned. Use this to retrieve additional fields. The elements of this list should be valid field names for the task resource. This is an array, not a comma-separated string. |
| `opt_pretty` | boolean |          | —                              | If true, the response JSON will be 'pretty-printed' with indentation and line breaks, making it more readable. This is useful for debugging but may increase response time and size.                                                                                                               |

***

### `Asana Update Custom Field`

Integration name: **ASANA\_UPDATE\_CUSTOM\_FIELD**

Tool to update a custom field by its globally unique identifier. Use when you need to modify properties of an existing custom field in Asana.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                                 | Description                                                                                                                                                                                                          |
| ------------------ | ------- | :------: | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`             | object  |     ✅    | —                                       | The data to update the custom field with.                                                                                                                                                                            |
| `opt_fields`       | array   |          | `["name","description","enum_options"]` | This endpoint returns a compact 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. |
| `opt_pretty`       | boolean |          | —                                       | Provides “pretty” output.                                                                                                                                                                                            |
| `custom_field_gid` | string  |     ✅    | `"12345"`                               | Globally unique identifier for the custom field.                                                                                                                                                                     |

***

### `Asana Update Enum Option`

Integration name: **ASANA\_UPDATE\_ENUM\_OPTION**

Tool to update an enum option for a custom field. Use when you need to modify the name, color, or enabled status of an existing enum option.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                      | Description                                                                                                                 |
| ----------------- | ------- | :------: | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `data`            | object  |     ✅    | —                            | The data to update the enum option with.                                                                                    |
| `opt_fields`      | array   |          | `["name","color","enabled"]` | Defines the fields to be returned in the response.                                                                          |
| `opt_pretty`      | boolean |          | —                            | Provides “pretty” output. Formatting of the result will follow JSON pretty print conventions (line breaks and indentation). |
| `enum_option_gid` | string  |     ✅    | `"12345"`                    | Globally unique identifier for the enum option.                                                                             |

***

### `Asana Update Project`

Integration name: **ASANA\_UPDATE\_PROJECT**

Update a project.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                                     | Description                                                                                                                                                                                 |
| --------------- | ------- | :------: | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`          | string  |          | `"New Project Name"`                                        | The name of the project. Note: User task lists (My Tasks) are special system-managed projects whose names cannot be changed. Attempting to rename a user task list will result in an error. |
| `team`          | string  |          | `"12345"`                                                   | The GID of the team that this project is shared with.                                                                                                                                       |
| `color`         | string  |          | `"light-green"`                                             | Color of the project.                                                                                                                                                                       |
| `notes`         | string  |          | `"This is a new description for the project."`              | Free-form textual information associated with the project (its description).                                                                                                                |
| `owner`         | string  |          | `"12345"`                                                   | The GID of the new owner of the project. May be null.                                                                                                                                       |
| `due_on`        | string  |          | `"2023-12-31"`                                              | The day on which this project is due. This takes a date with format YYYY-MM-DD.                                                                                                             |
| `public`        | boolean |          | —                                                           | True if the project is public to its team.                                                                                                                                                  |
| `archived`      | boolean |          | —                                                           | True if the project is archived, false if not.                                                                                                                                              |
| `due_date`      | string  |          | `"2023-12-31"`                                              | The localized day on which this project is due. This takes a date with format YYYY-MM-DD.                                                                                                   |
| `start_on`      | string  |          | `"2023-01-01"`                                              | The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format.                                                          |
| `html_notes`    | string  |          | `"<body>This is a new description for the project.</body>"` | [Opt In](broken://pages/1767a04d0562a7a7b848f78d1f2ac303851c2924). The notes of the project with formatting as HTML.                                                                        |
| `is_template`   | boolean |          | —                                                           | [Opt In](broken://pages/1767a04d0562a7a7b848f78d1f2ac303851c2924). True if the project is a template.                                                                                       |
| `project_gid`   | string  |     ✅    | `"12345"`                                                   | The GID of the project to update.                                                                                                                                                           |
| `default_view`  | string  |          | `"list"`                                                    | The default view (list, board, calendar, or timeline) of a project.                                                                                                                         |
| `custom_fields` | object  |          | `{"123":"value1","456":"value2"}`                           | An object where each key is the GID of a custom field and its corresponding value is the new value for that custom field.                                                                   |

***

### `Asana Update Project Brief`

Integration name: **ASANA\_UPDATE\_PROJECT\_BRIEF**

Tool to update a project brief by its GID. Use when you need to modify the content/description of a project brief. Note: Requires the project\_brief\_gid (not the project\_gid). First call 'Get a project' with opt\_fields=\['project\_brief'] to obtain the project\_brief\_gid.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                                                                                                              | Description                                                                                                                                                                                                                                                                                   |
| ------------------- | ------- | :------: | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `text`              | string  |          | `"Updated project brief text - Testing the UPDATE_PROJECT_BRIEF endpoint with valid authentication and parameters."` | The plain text content of the project brief. This field updates the main content/description of the project brief.                                                                                                                                                                            |
| `opt_fields`        | array   |          | —                                                                                                                    | 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. Available options: html\_text, permalink\_url, project, project.name, text, title |
| `opt_pretty`        | boolean |          | —                                                                                                                    | Provides 'pretty' output. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                                                                                                      |
| `project_brief_gid` | string  |     ✅    | `"1212598676699299"`                                                                                                 | Globally unique identifier for the project brief. This is NOT the project GID. Must be a numeric string. To obtain a project\_brief\_gid, first call 'Get a project' with opt\_fields=\['project\_brief'] to retrieve the project's brief object, which contains the project\_brief\_gid.     |

***

### `Asana Update Section`

Integration name: **ASANA\_UPDATE\_SECTION**

Update a section's name or position within a project. Use when you need to rename a section or reorder sections by specifying insert\_before or insert\_after.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                          | Description                                                                                                                                                                                                 |
| --------------- | ------- | :------: | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`          | string  |          | `"Updated To Do Section"`                        | The new name for the section. This is the text displayed as the section header. Cannot be an empty string.                                                                                                  |
| `opt_fields`    | array   |          | `["created_at","name","project","project.name"]` | 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. |
| `opt_pretty`    | boolean |          | —                                                | Provides 'pretty' output with proper line breaking and indentation. Advisable only during debugging as it increases response time and size.                                                                 |
| `section_gid`   | string  |     ✅    | `"321654"`                                       | The globally unique identifier for the section to update.                                                                                                                                                   |
| `insert_after`  | string  |          | `"987654"`                                       | An existing section within this project after which the section should be inserted. Cannot be provided together with insert\_before.                                                                        |
| `insert_before` | string  |          | `"86420"`                                        | An existing section within this project before which the section should be inserted. Cannot be provided together with insert\_after.                                                                        |

***

### `Asana Update Story`

Integration name: **ASANA\_UPDATE\_STORY**

Tool to update a story on a task. Use when you need to modify the text, html\_text, or pin status of an existing story. Only comment stories can have text/html\_text updated, and only comment and attachment stories can be pinned.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                              | Description                                                                                                                                                                                                 |
| ------------ | ------- | :------: | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`       | object  |     ✅    | —                                    | An object containing the fields of the story to update.                                                                                                                                                     |
| `story_gid`  | string  |     ✅    | `"35678"`                            | Globally unique identifier for the story.                                                                                                                                                                   |
| `opt_fields` | array   |          | `["text","created_at","created_by"]` | 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. |
| `opt_pretty` | boolean |          | —                                    | Provides "pretty" output.                                                                                                                                                                                   |

***

### `Asana Update Tag`

Integration name: **ASANA\_UPDATE\_TAG**

Tool to update an existing tag by its globally unique identifier. Use when you need to change the name or color of a tag.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example | Description                                 |
| --------- | ------ | :------: | ------- | ------------------------------------------- |
| `data`    | object |     ✅    | —       | An object containing the fields to update.  |
| `tag_gid` | string |     ✅    | —       | The globally unique identifier for the tag. |

***

### `Asana Update Team`

Integration name: **ASANA\_UPDATE\_TEAM**

Tool to update details of an existing team. Use when you need to change a team's name, description, or organization.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example                               | Description                                                                                          |
| -------------- | ------- | :------: | ------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `name`         | string  |          | `"New Team Name"`                     | The new name of the team.                                                                            |
| `team_gid`     | string  |     ✅    | `"12345"`                             | Globally unique identifier for the team.                                                             |
| `opt_fields`   | array   |          | —                                     | Defines fields to return.                                                                            |
| `opt_pretty`   | boolean |          | —                                     | Provides “pretty” output.                                                                            |
| `description`  | string  |          | `"This is the new team description."` | The new description of the team.                                                                     |
| `organization` | string  |          | `"67890"`                             | GID of the organization to which the team belongs. This is the GID of an organization, not its name. |

***

### `Asana Update User`

Integration name: **ASANA\_UPDATE\_USER**

Update a user's custom fields. Note: Asana's API has very limited user update capabilities - most user properties are read-only and managed by users themselves.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                          | Description                                                                                                                                                                                                 |
| --------------- | ------- | :------: | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_gid`      | string  |     ✅    | `"me"`                           | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                            |
| `workspace`     | string  |          | `"12345"`                        | The workspace to filter results on.                                                                                                                                                                         |
| `opt_fields`    | array   |          | —                                | 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. |
| `opt_pretty`    | boolean |          | —                                | Provides 'pretty' output. Provides the response in a pretty format.                                                                                                                                         |
| `custom_fields` | object  |          | `{"1234567890":"Updated value"}` | An object where each key is a custom field GID and the value is the new value for that custom field. Note: User objects have very limited update capabilities in Asana's API.                               |

***

### `Asana Update User For Workspace`

Integration name: **ASANA\_UPDATE\_USER\_FOR\_WORKSPACE**

Tool to update a user in a workspace or organization. Use when you need to modify user-specific custom field values for a workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                                      | Description                                                                                                                                                                                                 |
| --------------- | ------- | :------: | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_gid`      | string  |     ✅    | `"12345"`                                                    | A string identifying a user. This can either be the string "me", an email, or the gid of a user.                                                                                                            |
| `opt_fields`    | array   |          | `["email","name","photo","workspaces"]`                      | 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. |
| `opt_pretty`    | boolean |          | —                                                            | Provides "pretty" output. This will take extra time and increase the response size so it is advisable only to use this during debugging.                                                                    |
| `custom_fields` | object  |          | `{"1234567890":"option_gid","0987654321":"Some text value"}` | Object mapping custom field GIDs to their values for the user. Values depend on field type: enum fields use option GIDs (strings), text fields use strings, number fields use numbers.                      |
| `workspace_gid` | string  |     ✅    | `"12345"`                                                    | Globally unique identifier for the workspace or organization.                                                                                                                                               |

***

### `Asana Update Webhook`

Integration name: **ASANA\_UPDATE\_WEBHOOK**

Tool to update an existing Asana webhook's filter configuration. Use when you need to modify which events trigger webhook notifications.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                                                                       | Description                                                                                                                                                                                                                                                                                |
| ------------- | ------- | :------: | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `filters`     | array   |          | `[{"action":"changed","fields":["name","completed"],"resource_type":"task"}]` | Array of WebhookFilter objects to specify which events should trigger this webhook. If a webhook event passes any of the filters, the event will be delivered; otherwise no event will be sent. Each filter can specify resource\_type, resource\_subtype, action, and/or fields to match. |
| `opt_fields`  | array   |          | `["active","filters","resource","target"]`                                    | Array of optional field names to include in the response. Common fields include: 'active', 'created\_at', 'filters', 'last\_failure\_at', 'last\_success\_at', 'resource', 'target'.                                                                                                       |
| `opt_pretty`  | boolean |          | —                                                                             | If true, the response JSON will be 'pretty-printed' with indentation and line breaks for readability. Useful for debugging but may increase response time and size.                                                                                                                        |
| `webhook_gid` | string  |     ✅    | `"1213245723496077"`                                                          | Globally unique identifier for the webhook to update.                                                                                                                                                                                                                                      |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/asana.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
