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.
Tools (153)
Asana Add Followers To Project
Asana Add Followers To ProjectIntegration 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.
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
Asana Add Followers To TaskIntegration 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.
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
Asana Add Item To PortfolioIntegration 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.
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
Asana Add Members To ProjectIntegration 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.
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
Asana Add Project For TaskIntegration 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.
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
Asana Add Supporting RelationshipIntegration 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.
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
Asana Add Tag To TaskIntegration 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.
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
Asana Add Task DependenciesIntegration 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.
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
Asana Add Task To SectionIntegration 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.
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
Asana Add User To TeamIntegration 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.
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
Asana Add User To WorkspaceIntegration 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.
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
Asana Approve Access RequestIntegration 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.
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
Asana Create Access RequestIntegration 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.
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
Asana Create AllocationIntegration 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.
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
Asana Create A ProjectIntegration 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.
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
Asana Create A Tag In A WorkspaceIntegration 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.
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
Asana Create A TaskIntegration 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.
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
Asana Create Attachment For ObjectIntegration 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.
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
Asana Create Attachment For TaskIntegration 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.
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
Asana Create Custom FieldIntegration 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.
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
Asana Create Enum Option For Custom FieldIntegration 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.
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
Asana Create MembershipIntegration 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.
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
Asana Create Project BriefIntegration 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.
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
Asana Create Project For TeamIntegration 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.
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
Asana Create Project For WorkspaceIntegration 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.
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
Asana Create Project Status UpdateIntegration 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.
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
Asana Create Section In ProjectIntegration 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.
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
Asana Create Status For ObjectIntegration 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.
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
Asana Create SubtaskIntegration 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.
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
Asana Create TagIntegration 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.
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
Asana Create Task CommentIntegration 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.
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
Asana Create TeamIntegration 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.
data
object
✅
—
The request data for creating a team.
Asana Delete Allocation
Asana Delete AllocationIntegration 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.
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
Asana Delete AttachmentIntegration 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.
opt_pretty
boolean
—
Provides “pretty” output.
attachment_gid
string
✅
"12345"
Globally unique identifier for the attachment.
Asana Delete Custom Field
Asana Delete Custom FieldIntegration 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.
custom_field_gid
string
✅
"12345"
Globally unique identifier for the custom field.
Asana Delete Membership
Asana Delete MembershipIntegration 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.
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
Asana Delete ProjectIntegration name: ASANA_DELETE_PROJECT
Delete a project.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
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
Asana Delete Project BriefIntegration 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.
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
Asana Delete Project StatusIntegration 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.
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
Asana Delete SectionIntegration 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.
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
Asana Delete Status UpdateIntegration 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.
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
Asana Delete StoryIntegration 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.
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
Asana Delete TagIntegration 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.
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
Asana Delete TaskIntegration name: ASANA_DELETE_TASK
Delete a task.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
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
Asana Duplicate ProjectIntegration name: ASANA_DUPLICATE_PROJECT
Duplicate a project.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
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
Asana Duplicate TaskIntegration name: ASANA_DUPLICATE_TASK
Duplicate a task
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
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
Asana Get Access RequestsIntegration 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.
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
Asana Get AllocationIntegration 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.
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
Asana Get AllocationsIntegration 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.
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
Asana Get A ProjectIntegration 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.
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
Asana Get A TaskIntegration 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.
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
Asana Get AttachmentIntegration 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.
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
Asana Get Audit Log EventsIntegration 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.
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
Asana Get A User Task ListIntegration 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.
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
Asana Get Current UserIntegration 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
Asana Get Custom FieldIntegration 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.
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
Asana Get Custom Fields For WorkspaceIntegration 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.
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
Asana Get Custom TypesIntegration 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.
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
Asana Get EventsIntegration 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.
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
Asana Get Favorites For UserIntegration 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.
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
Asana Get GoalIntegration 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.
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
Asana Get Goal RelationshipsIntegration 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.
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
Asana Get GoalsIntegration 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.
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
Asana Get JobIntegration 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.
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
Asana Get MembershipIntegration 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.
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
Asana Get MembershipsIntegration 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.
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
Asana Get Multiple ProjectsIntegration 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.
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
Asana Get Multiple TasksIntegration 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.
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
Asana Get Multiple UsersIntegration 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.
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
Asana Get Multiple WorkspacesIntegration 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.
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
Asana Get PortfolioIntegration 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.
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
Asana Get Portfolio ItemsIntegration 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.
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
Asana Get Portfolio MembershipsIntegration 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.
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
Asana Get PortfoliosIntegration 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.
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
Asana Get Project BriefIntegration 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.
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
Asana Get Project MembershipIntegration 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.
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
Asana Get Project MembershipsIntegration 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.
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
Asana Get Projects For TaskIntegration 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.
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
Asana Get Projects For TeamIntegration 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.
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
Asana Get Project StatusIntegration 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.
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
Asana Get Project Status UpdatesIntegration 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.
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
Asana Get Project TemplatesIntegration 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.
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
Asana Get Project Templates For TeamIntegration 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.
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
Asana Get Reactions On ObjectIntegration 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.
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
Asana Get SectionIntegration 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.
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
Asana Get Sections In ProjectIntegration 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.
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
Asana Get StatusIntegration 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.
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
Asana Get Status UpdatesIntegration 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.
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
Asana Get Stories For TaskIntegration 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.
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
Asana Get StoryIntegration 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.
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
Asana Get TagIntegration 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.
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
Asana Get TagsIntegration 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.
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
Asana Get Tags For TaskIntegration 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.
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
Asana Get Tags For WorkspaceIntegration 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.
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
Asana Get Task AttachmentsIntegration 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.
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
Asana Get Task Counts For ProjectIntegration 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.
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
Asana Get Tasks For TagIntegration 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.
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
Asana Get Tasks For User Task ListIntegration 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.
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
Asana Get Tasks From A ProjectIntegration 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.
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
Asana Get Tasks From SectionIntegration 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.
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
Asana Get Task SubtasksIntegration 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.
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
Asana Get Task TemplatesIntegration 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.
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
Asana Get TeamIntegration 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.
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
Asana Get Team MembershipIntegration 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.
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
Asana Get Team MembershipsIntegration 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.
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
Asana Get Team Memberships For TeamIntegration 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.
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
Asana Get Team Memberships For UserIntegration 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.
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
Asana Get Teams For UserIntegration 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.
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
Asana Get Teams In WorkspaceIntegration 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.
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
Asana Get Time PeriodIntegration 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.
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
Asana Get Time PeriodsIntegration 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.
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
Asana Get Time Tracking EntriesIntegration 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.
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
Asana Get Time Tracking Entries For TaskIntegration 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.
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
Asana Get Typeahead ObjectsIntegration 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.
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
Asana Get UserIntegration 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.
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
Asana Get User For WorkspaceIntegration 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.
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
Asana Get Users For TeamIntegration 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.
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
Asana Get Users For WorkspaceIntegration 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.
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
Asana Get User Task ListIntegration 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.
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
Asana Get WebhooksIntegration 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.
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
Asana Get WorkspaceIntegration 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.
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
Asana Get Workspace MembershipIntegration 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.
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
Asana Get Workspace MembershipsIntegration 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.
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
Asana Get Workspace Memberships For UserIntegration 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.
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
Asana Get Workspace ProjectsIntegration 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.
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
Asana Insert Enum Option For Custom FieldIntegration 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.
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
Asana Insert Section For ProjectIntegration 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.
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
Asana Instantiate Project TemplateIntegration 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.
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
Asana Reject Access RequestIntegration 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.
access_request_gid
string
✅
"12345"
Globally unique identifier for the access request to reject. Must be a numeric string.
Asana Remove Follower From Task
Asana Remove Follower From TaskIntegration 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.
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
Asana Remove Followers For ProjectIntegration 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.
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
Asana Remove Item From PortfolioIntegration 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.
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
Asana Remove Members For ProjectIntegration 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.
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
Asana Remove Project From TaskIntegration 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.
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
Asana Remove Tag From TaskIntegration 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.
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
Asana Remove User For TeamIntegration 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.
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
Asana Remove User For WorkspaceIntegration 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.
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
Asana Search Tasks In WorkspaceIntegration 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.
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
Asana Set Parent For TaskIntegration 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.
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
Asana Submit Parallel RequestsIntegration 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.
data
object
✅
—
Contains the list of actions to be performed in parallel.
Asana Update Allocation
Asana Update AllocationIntegration 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.
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
Asana Update A TaskIntegration 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.
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
Asana Update Custom FieldIntegration 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.
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
Asana Update Enum OptionIntegration 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.
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
Asana Update ProjectIntegration name: ASANA_UPDATE_PROJECT
Update a project.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
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. The notes of the project with formatting as HTML.
is_template
boolean
—
Opt In. 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
Asana Update Project BriefIntegration 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.
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
Asana Update SectionIntegration 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.
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
Asana Update StoryIntegration 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.
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
Asana Update TagIntegration 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.
data
object
✅
—
An object containing the fields to update.
tag_gid
string
✅
—
The globally unique identifier for the tag.
Asana Update Team
Asana Update TeamIntegration 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.
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
Asana Update UserIntegration 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.
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
Asana Update User For WorkspaceIntegration 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.
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
Asana Update WebhookIntegration 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.
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.