Asana

asana

Tool to help teams organize, track, and manage their work.

Project Management Task Management Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (84)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Add Followers to TaskASANA_ADD_FOLLOWERS_TO_TASKAcción

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.

Parámetros de entrada

task_gidstringObligatorio
The globally unique identifier for the task.
followersstring[]Obligatorio
An array of user GIDs to add as followers to the task. For example: ["12345", "67890"].
opt_fieldsstring[]
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_prettyboolean
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.

Parámetros de salida

dataobjectObligatorio
The task with updated followers.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Add Supporting Relationship to GoalASANA_ADD_SUPPORTING_RELATIONSHIPAcción

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.

Parámetros de entrada

dataobjectObligatorio
goal_gidstringObligatorio
Globally unique identifier for the goal.
opt_fieldsstring[]
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_prettyboolean
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.

Parámetros de salida

dataobject
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Add task to sectionASANA_ADD_TASK_TO_SECTIONAcción

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.

Parámetros de entrada

task_gidstringObligatorio
GID of the existing task to add.
section_gidstringObligatorio
GID of the target section.
insert_afterstring
GID of a task in the section after which to insert the current task. Mutually exclusive with `insert_before`.
insert_beforestring
GID of a task in the section before which to insert the current task. Mutually exclusive with `insert_after`.

Parámetros de salida

dataobjectObligatorio
Empty dictionary confirming successful addition.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create AllocationASANA_CREATE_ALLOCATIONAcción

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.

Parámetros de entrada

notesstring
Any additional notes related to the allocation.
end_onstringObligatoriodate
The end date of the allocation. The format is YYYY-MM-DD.
start_onstringObligatoriodate
The start date of the allocation. The format is YYYY-MM-DD.
project_gidstring
The project GID for which this allocation is being made. If provided, the allocation will be linked to this project.
assignee_gidstringObligatorio
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.
workspace_gidstringObligatorio
The ID of the workspace where the allocation will be created.
minutes_per_weekintegerObligatorio
The number of minutes per week the user is allocated for. Must be greater than 0.

Parámetros de salida

dataobjectObligatorio
The full record of the newly created allocation.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a projectASANA_CREATE_A_PROJECTAcción

Creates a new asana project, requiring either a `workspace` or `team` gid for association, and returns the full project details.

Parámetros de entrada

dataobjectObligatorio
Data payload for the new project.
opt_fieldsstring[]
Comma-separated optional properties to include in the response (e.g., 'name,notes').
opt_prettyboolean
True for human-readable JSON response (debugging only due to size/processing).

Parámetros de salida

dataobjectObligatorio
Contains the newly created project resource.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a tag in a workspaceASANA_CREATE_A_TAG_IN_A_WORKSPACEAcción

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.

Parámetros de entrada

dataobjectObligatorio
The properties for the tag creation, including name (required), color (optional), and notes (optional).
opt_fieldsstring[]
Comma-separated string of fields from `OptFieldsEnm0` (e.g., 'name', 'color') to include in the response; returns a compact representation by default.
opt_prettyboolean
If true, pretty-prints the JSON response; useful for debugging but may increase response size.
workspace_gidstringObligatorio
The globally unique identifier (GID) for the workspace or organization in which to create the tag.

Parámetros de salida

dataobjectObligatorio
The full response object encapsulating the details of the created tag resource.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create task in asana with specific detailsASANA_CREATE_A_TASKAcción

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

Parámetros de entrada

dataobjectObligatorio
Task details for creation.
opt_fieldsstring[]
Comma-separated list of optional properties for response. Default is compact resource.
opt_prettyboolean
Provides 'pretty' JSON output with line breaks/indentation. Useful for debugging; may increase response time/size.

Parámetros de salida

dataobjectObligatorio
Full details of the newly created task.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Attachment for TaskASANA_CREATE_ATTACHMENT_FOR_TASKAcción

Tool to upload an attachment to a task. use when you need to attach a file to a specific task in asana.

Parámetros de entrada

file_namestringObligatorio
The name of the file.
parent_gidstringObligatorio
Globally unique identifier for the parent task or comment.
file_contentstringObligatoriobinary
The file content to be uploaded.
connect_to_appboolean
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_subtypestring
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.
file_content_typestringObligatorio
The content type of the file. E.g. 'application/pdf' or 'image/jpeg'.

Parámetros de salida

dataobject
The attachment object that was created.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Custom FieldASANA_CREATE_CUSTOM_FIELDAcción

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.

Parámetros de entrada

dataobjectObligatorio
The custom field object to create.
opt_fieldsstring[]
Comma-separated list of properties to include in the response.
opt_prettyboolean
Provides “pretty” output.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Enum Option for Custom FieldASANA_CREATE_ENUM_OPTION_FOR_CUSTOM_FIELDAcción

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.

Parámetros de entrada

dataobjectObligatorio
The enum option to create.
opt_fieldsstring[]
Defines fields to return.
opt_prettyboolean
Provides “pretty” output.
custom_field_gidstringObligatorio
Globally unique identifier for the custom field.

Parámetros de salida

dataobject
The enum option created.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Project Status UpdateASANA_CREATE_PROJECT_STATUS_UPDATEAcción

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.

Parámetros de entrada

textstringObligatorio
The HTML content of the status update.
colorstringObligatorioenum
Color of the status update. Supported values: GREEN, YELLOW, RED, BLUE, COMPLETE.
GREENYELLOWREDBLUECOMPLETE
titlestringObligatorio
The title of the project status update.
project_gidstringObligatorio
Globally unique identifier for the project.
status_typestringObligatorioenum
The type of status. Must be one of: on_track, at_risk, off_track, on_hold, complete.
on_trackat_riskoff_trackon_holdcomplete

Parámetros de salida

dataobject
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a section in a projectASANA_CREATE_SECTION_IN_PROJECTAcción

Creates a new section in a project, optionally positioned relative to an existing section in the same project, and returns the full record of the new section.

Parámetros de entrada

namestringObligatorio
Name for the new section.
project_gidstringObligatorio
GID of the project where the section will be created.
insert_afterstring
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_beforestring
GID of an existing section to insert the new section before; if omitted, the new section is added at the end.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create subtaskASANA_CREATE_SUBTASKAcción

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.

Parámetros de entrada

namestringObligatorio
The name of the subtask to be created.
notesstring
Optional descriptive text for the subtask.
due_atstring
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_onstring
Optional due date for the subtask in YYYY-MM-DD format, representing the end of the day for the task.
assigneestring
Optional Global ID (GID) of the user to whom the subtask will be assigned. If not provided, the subtask will be unassigned.
task_gidstringObligatorio
The Global ID (GID) of the parent task under which the subtask will be created.
completedboolean
Optional flag to mark the subtask as completed upon creation. Defaults to false if not specified.
followersstring[]
Optional array of user Global IDs (GIDs) to add as followers to the subtask. Followers receive notifications about subtask updates.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create task commentASANA_CREATE_TASK_COMMENTAcción

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

Parámetros de entrada

textstringObligatorio
The plain text content of the comment to be posted on the task. HTML or rich text is not supported via this field.
task_idstringObligatorio
The globally unique identifier (GID) of the Asana task to which the comment will be added.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create TeamASANA_CREATE_TEAMAcción

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

Parámetros de entrada

dataobjectObligatorio

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete AllocationASANA_DELETE_ALLOCATIONAcción

Tool to delete an allocation by its id. use this when you need to remove a specific resource allocation in asana.

Parámetros de entrada

opt_prettyboolean
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_gidstringObligatorio
Globally unique identifier for the allocation.

Parámetros de salida

dataobject
An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete AttachmentASANA_DELETE_ATTACHMENTAcción

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

Parámetros de entrada

opt_prettyboolean
Provides “pretty” output.
attachment_gidstringObligatorio
Globally unique identifier for the attachment.

Parámetros de salida

dataobject
An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Custom FieldASANA_DELETE_CUSTOM_FIELDAcción

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

Parámetros de entrada

custom_field_gidstringObligatorio
Globally unique identifier for the custom field.

Parámetros de salida

dataobject
Empty object returned upon successful deletion.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete a projectASANA_DELETE_PROJECTAcción

Delete a project.

Parámetros de entrada

opt_prettyboolean
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_gidstringObligatorio
Globally unique identifier for the project.

Parámetros de salida

dataobject
An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete a TagASANA_DELETE_TAGAcción

Tool to delete a specific tag by its gid. use when you need to remove an existing tag from asana.

Parámetros de entrada

tag_gidstringObligatorio
The globally unique identifier for the tag.
opt_prettyboolean
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.

Parámetros de salida

dataobject
An empty object indicating successful deletion.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete a taskASANA_DELETE_TASKAcción

Delete a task.

Parámetros de entrada

task_gidstringObligatorio
The task to operate on.
opt_prettyboolean
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.

Parámetros de salida

dataobject
An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Duplicate ProjectASANA_DUPLICATE_PROJECTAcción

Duplicate a project.

Parámetros de entrada

namestringObligatorio
The name of the new project.
teamstring
Globally unique identifier for the team that the new project will belong to.
includestring[]
A list of elements to be included in the duplication.
project_gidstringObligatorio
Globally unique identifier for the project to be duplicated.
schedule_datesobject
Scheduling information for the new project.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Duplicate TaskASANA_DUPLICATE_TASKAcción

Duplicate a task

Parámetros de entrada

namestring
The name of the new task.
includestring[]
A comma-separated string of properties to copy from the original task.
task_gidstringObligatorio
The globally unique identifier for the task to be duplicated.

Parámetros de salida

dataobject
A job is an object representing a process that handles asynchronous work.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get AllocationASANA_GET_ALLOCATIONAcción

Get an allocation by id. use when you need to retrieve the details of a specific allocation.

Parámetros de entrada

opt_fieldsstring[]
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_prettyboolean
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_gidstringObligatorio
Globally unique identifier for the allocation.

Parámetros de salida

dataobject
The allocation record.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get AllocationsASANA_GET_ALLOCATIONSAcción

Tool to get multiple allocations. use when you need to retrieve a list of allocations, optionally filtered by project, user, or workspace.

Parámetros de entrada

limitinteger
Results per page.
offsetstring
Offset token.
parentstring
Globally unique identifier for the project to filter allocations by.
assigneestring
Globally unique identifier for the user or placeholder the allocation is assigned to.
workspacestring
Globally unique identifier for the workspace.
opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output.

Parámetros de salida

dataobject[]Obligatorio
Successfully retrieved the requested allocations.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Conditional. This property is only present when a limit query parameter is provided in the request. When making a paginated request, the API will return a number of results as specified by the limit parameter. If more results exist, then the response will contain a next_page attribute, which will include an offset, a relative path attribute, and a full uri attribute. If there are no more pages available, next_page will be null and no offset will be provided. Note that an offset token will expire after some time, as data may have changed.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get a projectASANA_GET_A_PROJECTAcción

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.

Parámetros de entrada

opt_fieldsstring[]
Defines a comma-separated list of optional fields for a more detailed project representation in the response, beyond the default compact view.
opt_prettyboolean
Pretty-prints the JSON response for readability, useful for debugging.
project_gidstringObligatorio
Globally unique identifier for the project.

Parámetros de salida

dataobjectObligatorio
Contains the project details.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get a taskASANA_GET_A_TASKAcción

Retrieves full details for a specified task gid accessible by the user; use `opt fields` to customize returned data.

Parámetros de entrada

task_gidstringObligatorio
Globally unique identifier (GID) of the task.
opt_fieldsstring[]
Comma-separated list of optional fields to include (e.g., `assignee`, `custom_fields.name`) for a more detailed response beyond the default compact representation.
opt_prettyboolean
If true, formats JSON response with indentation for readability; for debugging, as it increases response size/time.

Parámetros de salida

dataobjectObligatorio
The response data containing the task.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get AttachmentASANA_GET_ATTACHMENTAcción

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.

Parámetros de entrada

opt_fieldsstring
A comma-separated list of fields to include in the response. For example: "name,size,url".
attachment_gidstringObligatorio
The globally unique identifier for the attachment.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Audit Log EventsASANA_GET_AUDIT_LOG_EVENTSAcción

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.

Parámetros de entrada

limitinteger
Results per page. The number of objects to return per page. The value must be between 1 and 100.
end_atstringdate-time
Filter to events created before this time (exclusive).
offsetstring
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_atstringdate-time
Filter to events created after this time (inclusive).
actor_gidstring
Filter to events triggered by the actor with this ID.
actor_typestring
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_typestring
Filter to events of this type. Refer to the supported audit log events for a full list of values.
resource_gidstring
Filter to events with this resource ID.
workspace_gidstringObligatorio
Globally unique identifier for the workspace or organization.

Parámetros de salida

dataobject[]
A list of audit log events.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination data for the next page.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get a user task listASANA_GET_A_USER_TASK_LISTAcción

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`.

Parámetros de entrada

workspacestringObligatorio
The GID of the workspace to filter the user task list.
opt_fieldsstring[]
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_prettyboolean
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_gidstringObligatorio
The globally unique identifier (GID) for the user task list to be retrieved.

Parámetros de salida

dataobjectObligatorio
The main data object containing the details of the requested user task list.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get current userASANA_GET_CURRENT_USERAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Custom FieldASANA_GET_CUSTOM_FIELDAcción

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.

Parámetros de entrada

opt_fieldsstring[]
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_prettyboolean
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_gidstringObligatorio
Globally unique identifier for the custom field.

Parámetros de salida

dataobject
The custom field object.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Custom Fields for WorkspaceASANA_GET_CUSTOM_FIELDS_FOR_WORKSPACEAcción

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.

Parámetros de entrada

limitinteger
Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstring
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_fieldsstring[]
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_prettyboolean
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_gidstringObligatorio
Globally unique identifier for the workspace or organization.

Parámetros de salida

dataobject[]Obligatorio
The list of custom fields.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Provides the offset for the next page of results, if any.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Events on a ResourceASANA_GET_EVENTSAcción

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.

Parámetros de entrada

syncstring
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_fieldsstring[]
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_prettyboolean
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_gidstringObligatorio
Globally unique identifier for the resource.

Parámetros de salida

dataobject[]
The list of events.
syncstring
A sync token to be used with the next call to the /events endpoint.
errorstring
Error if any occurred during the execution of the action
has_moreboolean
Indicates whether there are more events to retrieve.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get GoalASANA_GET_GOALAcción

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

Parámetros de entrada

goal_gidstringObligatorio
Globally unique identifier for the goal.
opt_fieldsstring
Comma-separated list of fields to include in the response. Example: "name,notes,due_on"

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Goal RelationshipsASANA_GET_GOAL_RELATIONSHIPSAcción

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

Parámetros de entrada

limitinteger
The number of objects to return per page.
offsetstring
Offset token for pagination.
goal_gidstringObligatorio
The globally unique identifier for the goal.
opt_fieldsstring[]
Defines fields to return.
opt_prettyboolean
Provides “pretty” output.

Parámetros de salida

dataobject[]Obligatorio
The list of goal relationships.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get GoalsASANA_GET_GOALSAcción

Tool to retrieve multiple goals. use when you need to get a list of goals, optionally filtered by workspace, team, portfolio, project, time period, or archived status.

Parámetros de entrada

teamstring
Globally unique identifier for the team.
limitinteger
The number of results to return.
offsetstring
Offset token for pagination.
projectstring
Globally unique identifier for the project.
archivedboolean
Filter to archived goals.
portfoliostring
Globally unique identifier for the portfolio.
workspacestring
Globally unique identifier for the workspace or organization.
opt_fieldsstring[]
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_periodstring
Globally unique identifier for the time period.
is_workspace_levelboolean
Filter to goals at the workspace level.

Parámetros de salida

dataobject[]
An array of goal objects.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get MembershipsASANA_GET_MEMBERSHIPSAcción

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.

Parámetros de entrada

limitinteger
The number of results to return per page.
memberstring
GID of the member (user or team) to filter memberships.
offsetstring
Offset token for pagination.
parentstring
GID of the parent resource (e.g., project_gid, goal_gid, portfolio_gid, or custom_field_gid) to filter memberships.
opt_fieldsstring
Comma-separated list of fields to include in the response (e.g., "parent,member,access_level,parent.name,member.name").

Parámetros de salida

dataobject[]Obligatorio
List of membership objects.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination data for the next page.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get multiple projectsASANA_GET_MULTIPLE_PROJECTSAcción

Returns a list of projects, optionally filtered by workspace, team, or archived status, supporting pagination for large datasets.

Parámetros de entrada

teamstring
GID of the team to filter projects by.
limitinteger
Number of projects to return per page (1-100).
offsetstring
Offset token from a previous paginated request for retrieving the next page of results. Only use tokens from previous responses.
archivedboolean
Filter projects by archived status: `True` for archived only, `False` for unarchived only.
workspacestring
GID of the workspace or organization to filter projects by.
opt_fieldsstring[]
Comma-separated list of optional properties to include for richer project details, as the default response is compact. See `OptFieldsEnm0` for available fields.
opt_prettyboolean
Return JSON in a 'pretty' format (indented, line breaks). For debugging only due to increased response size/time.

Parámetros de salida

dataobjectObligatorio
List of project records and pagination information, if applicable.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get multiple tasksASANA_GET_MULTIPLE_TASKSAcción

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

Parámetros de entrada

limitinteger
Number of task objects to return per page (must be between 1 and 100).
offsetstring
Offset token for pagination, from a previous paginated request. If omitted, returns the first page.
projectstring
Project GID to filter tasks on.
sectionstring
Section GID to filter tasks on. Tasks must be in a project that contains sections.
assigneestring
Filter tasks by assignee's GID (user GID, 'me', or 'assignee.any=null' for unassigned). Note: If `assignee` is specified, `workspace` must also be provided.
workspacestring
Workspace GID to filter tasks on. Note: If `workspace` is specified, `assignee` must also be provided.
opt_fieldsstring[]
Optional fields to include for more detailed task information; see `OptFieldsEnm0` for available keys.
opt_prettyboolean
Format JSON output with line breaking and indentation for readability (for debugging; may increase response time/size).
modified_sincestring
Return tasks modified since the given ISO 8601 date-time. 'Modified' includes property changes, association changes (e.g., task added to project), assigning, renaming, completing, or adding stories.
completed_sincestring
Filter for tasks incomplete or completed since this ISO 8601 date-time.

Parámetros de salida

dataobjectObligatorio
The main data payload, containing the list of tasks and pagination information.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get multiple usersASANA_GET_MULTIPLE_USERSAcción

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.

Parámetros de entrada

teamstring
The GID of the Asana team. If specified, only includes users who are members of this team.
limitinteger
The maximum number of user objects to return per page (1-100).
offsetstring
Opaque token for pagination to retrieve the subsequent page of results.
workspacestring
The GID of the Asana workspace or organization. If specified, only includes users belonging to this workspace.
opt_fieldsstring[]
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_prettyboolean
Return the response in a human-readable JSON format.

Parámetros de salida

dataobjectObligatorio
API response payload. Contains `errors` on failure or user list on success.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get multiple workspacesASANA_GET_MULTIPLE_WORKSPACESAcción

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

Parámetros de entrada

limitinteger
The maximum number of workspace objects to return per page. Must be an integer between 1 and 100, inclusive.
offsetstring
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_fieldsstring[]
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_prettyboolean
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.

Parámetros de salida

dataobjectObligatorio
Contains the list of workspaces and pagination information.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get PortfolioASANA_GET_PORTFOLIOAcción

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

Parámetros de entrada

limitinteger
Results per page. Max 100.
offsetstring
Offset token for pagination.
opt_fieldsstring[]
Defines fields to return. Example: ["name", "color", "due_on"]
opt_prettyboolean
Provides “pretty” output.
portfolio_gidstringObligatorio
Globally unique identifier for the portfolio.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Portfolio ItemsASANA_GET_PORTFOLIO_ITEMSAcción

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

Parámetros de entrada

limitinteger
Number of results to return per page.
offsetstring
Offset token to request next page.
opt_fieldsstring[]
Fields to include in response. Refer to Asana API documentation for possible values.
portfolio_gidstringObligatorio
Globally unique identifier for the portfolio.

Parámetros de salida

dataobject[]
List of items in the portfolio.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination information for the next page.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Portfolio MembershipsASANA_GET_PORTFOLIO_MEMBERSHIPSAcción

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.

Parámetros de entrada

userstring
A string identifying a user. This can either be the string "me", an email, or the GID of a user.
limitinteger
Results per page. The number of objects to return per page. Must be between 1 and 100, inclusive.
offsetstring
Offset token. An offset to paginate from. This can be retrieved from the ‘next_page’ field in the previous response.
portfoliostring
The GID of the portfolio to filter memberships on.
workspacestring
The GID of the workspace to filter memberships on.
opt_fieldsstring[]
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.

Parámetros de salida

dataobject[]
errorstring
Error if any occurred during the execution of the action
next_pageobject
Provides the offset for the next page of results, if any.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get PortfoliosASANA_GET_PORTFOLIOSAcción

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

Parámetros de entrada

limitinteger
The number of objects to return per page. Must be between 1 and 100.
ownerstring
The user GID who owns the portfolio. If specified, returns portfolios owned by this user.
offsetstring
An offset token for pagination.
workspacestringObligatorio
The workspace or organization GID to filter portfolios on.
opt_fieldsstring[]
Fields to include in the response. For example: ['name', 'color', 'owner'].

Parámetros de salida

dataobject[]Obligatorio
An array of portfolio objects.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination data for the next page of results.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Project BriefASANA_GET_PROJECT_BRIEFAcción

Tool to retrieve a project's brief. use when you need to get the detailed explanation (what and why) of a project.

Parámetros de entrada

opt_fieldsstring[]
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_prettyboolean
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_gidstringObligatorio
Globally unique identifier for the project brief.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Project MembershipsASANA_GET_PROJECT_MEMBERSHIPSAcción

Tool to retrieve memberships from a project. it can also be used to get memberships for a user across multiple projects or all projects in a workspace.

Parámetros de entrada

userstring
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
limitinteger
Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstring
Offset token. An offset to the next page returned by the API.
projectstring
The GID of the project to filter memberships by.
workspacestring
The GID of the workspace to filter memberships by.
opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output. Adds a `pretty` query parameter to the request. Do not use in production.

Parámetros de salida

dataobject[]
List of project memberships.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination information for the next page of results.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Projects for TeamASANA_GET_PROJECTS_FOR_TEAMAcción

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.

Parámetros de entrada

limitinteger
Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstring
Offset token. An offset to the next page returned by the API.
archivedboolean
Only return projects whose `archived` field takes on the value of this parameter.
team_gidstringObligatorio
Globally unique identifier for the team.
opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output.

Parámetros de salida

dataobject[]Obligatorio
A list of project objects.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination token for the next page of results.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Project StatusASANA_GET_PROJECT_STATUSAcción

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.

Parámetros de entrada

opt_fieldsstring[]
Fields to include in the response.
opt_prettyboolean
Provides “pretty” output.
project_status_gidstringObligatorio
Globally unique identifier for the project status.

Parámetros de salida

dataobject
The project status object.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Project Status UpdatesASANA_GET_PROJECT_STATUS_UPDATESAcción

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.

Parámetros de entrada

limitinteger
Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstring
Offset token. An offset to paginate from. This can be retrieved from the 'next_page' field in a previous response.
opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output. Adds indentation and newlines to the response. This can be useful when debugging but increases the response size.
project_gidstringObligatorio
Globally unique identifier for the project.

Parámetros de salida

dataobject[]
The list of project status updates.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination information for the next page of results, if available.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Multiple Project TemplatesASANA_GET_PROJECT_TEMPLATESAcción

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

Parámetros de entrada

limitinteger
Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstring
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_gidstring
The globally unique identifier for the team.
opt_fieldsstring[]
A comma-separated list of fields to include in the response. For example: name,description,owner,team,public
workspace_gidstring
The globally unique identifier for the workspace.

Parámetros de salida

dataobject[]Obligatorio
List of project templates.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Contains an offset token to retrieve the next page of results, if any.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get SectionASANA_GET_SECTIONAcción

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.

Parámetros de entrada

opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output.
section_gidstringObligatorio
The globally unique identifier for the section.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get sections in a projectASANA_GET_SECTIONS_IN_PROJECTAcción

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

Parámetros de entrada

limitinteger
Number of sections to return per page (1-100).
offsetstring
Token for pagination to retrieve the next page of results.
project_gidstringObligatorio
Globally unique identifier (GID) of the project.

Parámetros de salida

dataobject[]Obligatorio
List of compact section records.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Status UpdatesASANA_GET_STATUS_UPDATESAcción

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.

Parámetros de entrada

limitinteger
The maximum number of items to return per page. The value must be between 1 and 100.
offsetstring
An offset token returned from a previous query that had a `next_page` property. This is used for pagination.
parentstringObligatorio
Globally unique identifier (GID) of the object (project, portfolio, or goal) from which to fetch status updates.
opt_fieldsstring[]
A comma-separated list of fields to include in the response. This allows customization of the returned data.

Parámetros de salida

dataobject[]Obligatorio
An array of status update objects.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination information for the next page of results.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Stories for TaskASANA_GET_STORIES_FOR_TASKAcción

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.

Parámetros de entrada

limitinteger
Results per page. The number of results per page (between 1 and 100).
offsetstring
Offset token for pagination.
task_gidstringObligatorio
The GID of the task to get stories from.
opt_fieldsstring[]
A comma-separated list of optional properties to include in the response.

Parámetros de salida

dataobject[]
A list of story objects.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination information for the next page of results.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get StoryASANA_GET_STORYAcción

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

Parámetros de entrada

story_gidstringObligatorio
Globally unique identifier for the story.
opt_fieldsstring[]
A comma-separated list of fields to include in the response.
opt_prettyboolean
Provides "pretty" output.

Parámetros de salida

dataobject
The story object.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get TagASANA_GET_TAGAcción

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

Parámetros de entrada

tag_gidstringObligatorio
Globally unique identifier for the tag.
opt_fieldsstring[]
A comma-separated list of properties to include in the response.
opt_prettyboolean
If true, provides "pretty" (i.e., human-readable) JSON output.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get TagsASANA_GET_TAGSAcción

Get multiple tags in a workspace.

Parámetros de entrada

limitinteger
Results per page.
offsetstring
Offset token for pagination.
workspacestring
The GID of the workspace to filter tags on.
opt_fieldsstring[]
Comma-separated list of optional properties to include in the response.

Parámetros de salida

dataobject[]Obligatorio
List of tags.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination information for the next page of results.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Task AttachmentsASANA_GET_TASK_ATTACHMENTSAcción

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.

Parámetros de entrada

limitinteger
The number of results per page.
offsetstring
An offset token, used for pagination to retrieve the next page of results.
opt_fieldsstring[]
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_gidstringObligatorio
The GID of the task, project, or project_brief to fetch attachments from.

Parámetros de salida

dataobject[]
A list of attachment objects.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination information for the next page of results, if available.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Retrieve tasks for projectASANA_GET_TASKS_FROM_A_PROJECTAcción

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

Parámetros de entrada

limitinteger
Maximum number of tasks to return per page (1-100).
offsetstring
Opaque offset token for pagination from a previous request. If omitted, returns first page. Tokens may expire.
opt_fieldsstring[]
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_prettyboolean
If true, returns human-readable JSON; useful for debugging but increases response size.
project_gidstringObligatorio
Globally unique identifier (GID) of the project.
completed_sincestring
Filters tasks: returns incomplete tasks or those completed after the specified ISO 8601 date-time (e.g., '2023-10-26T10:00:00Z') or 'now'.

Parámetros de salida

dataobjectObligatorio
The structured response containing a list of tasks and pagination information.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Task SubtasksASANA_GET_TASK_SUBTASKSAcción

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

Parámetros de entrada

limitinteger
Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstring
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_gidstringObligatorio
The globally unique identifier for the task.
opt_fieldsstring[]
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.

Parámetros de salida

dataobject[]Obligatorio
A list of subtasks.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination information for the next page of results.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Task TemplatesASANA_GET_TASK_TEMPLATESAcción

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

Parámetros de entrada

limitinteger
The number of objects to return per page.
offsetstring
Offset token for pagination.
opt_fieldsstring
Comma-separated list of fields to include in the response. For example: 'name,created_at,created_by'.
project_gidstring
Globally unique identifier for the project. One of project or workspace must be specified.
workspace_gidstring
Globally unique identifier for the workspace. One of project or workspace must be specified.

Parámetros de salida

dataobject[]
List of task template objects.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination details for the next page of results.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get TeamASANA_GET_TEAMAcción

Tool to retrieve details of a specific team by its gid. use when you need to fetch information about a particular team in asana.

Parámetros de entrada

team_gidstringObligatorio
Globally unique identifier for the team.
opt_fieldsstring[]
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_prettyboolean
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.

Parámetros de salida

dataobject
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Team MembershipsASANA_GET_TEAM_MEMBERSHIPSAcción

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.

Parámetros de entrada

teamstring
The team to filter memberships to.
userstring
A user gid to filter memberships to.
limitinteger
Results per page.
offsetstring
Offset token.
workspacestring
The workspace to filter memberships to.
opt_fieldsstring[]
Defines fields to return.
opt_prettyboolean
Adds indentation to JSON response.

Parámetros de salida

dataobject[]
List of team memberships.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get teams in workspaceASANA_GET_TEAMS_IN_WORKSPACEAcción

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

Parámetros de entrada

limitinteger
Results per page. The value must be between 1 and 100.
offsetstring
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_gidstringObligatorio
The Global ID (GID) of the workspace to get teams from.

Parámetros de salida

dataobject[]Obligatorio
Array of compact team objects visible to the authorized user in the workspace.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Time PeriodsASANA_GET_TIME_PERIODSAcción

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.

Parámetros de entrada

limitinteger
Results per page.
end_onstring
The last day of the time period, YYYY-MM-DD.
offsetstring
Offset token for pagination.
start_onstring
The first day of the time period, YYYY-MM-DD.
opt_fieldsstring[]
A comma-separated list of fields to include in the response.
opt_prettyboolean
Provides the response in "pretty" output.
workspace_gidstringObligatorio
Globally unique identifier for the workspace.

Parámetros de salida

dataobject[]Obligatorio
List of time periods.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination data for the next page.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Objects via TypeaheadASANA_GET_TYPEAHEAD_OBJECTSAcción

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.

Parámetros de entrada

countinteger
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.
querystring
The string that will be used to search for relevant objects. If an empty string is passed in, the API will return results.
opt_fieldsstring[]
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_prettyboolean
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_typestringenum
The type of values the typeahead should return.
custom_fieldgoalprojectproject_templateportfoliotagtaskteamuser
workspace_gidstringObligatorio
Globally unique identifier for the workspace or organization.

Parámetros de salida

dataobject[]Obligatorio
An array of objects found by the typeahead search.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get UserASANA_GET_USERAcción

Get a user by their id.

Parámetros de entrada

user_gidstringObligatorio
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Users for TeamASANA_GET_USERS_FOR_TEAMAcción

Get users in a team.

Parámetros de entrada

limitinteger
Results per page. The maximum is 2000.
offsetstring
Offset token.
team_gidstringObligatorio
Globally unique identifier for the team.
opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output.

Parámetros de salida

dataobject[]Obligatorio
A list of compact user records.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Contains an offset token to retrieve the next page of results, if any.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Users in WorkspaceASANA_GET_USERS_FOR_WORKSPACEAcción

Get users in a workspace or organization.

Parámetros de entrada

limitinteger
Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstring
Offset token for pagination requests.
opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable.
workspace_gidstringObligatorio
Globally unique identifier for the workspace or organization.

Parámetros de salida

dataobject[]Obligatorio
A list of users in the workspace.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination data for the next page of results.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get WorkspaceASANA_GET_WORKSPACEAcción

Tool to retrieve details of a specific workspace by its gid. use when you need to get information about a particular asana workspace.

Parámetros de entrada

opt_fieldsstring[]
This results in a compact response, suitable for data-transfer sensitive applications. Valid values are: gid, name, resource_type, email_domains, is_organization.
opt_prettyboolean
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_gidstringObligatorio
The globally unique identifier of the workspace.

Parámetros de salida

dataobject
The workspace object.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Workspace MembershipsASANA_GET_WORKSPACE_MEMBERSHIPSAcción

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

Parámetros de entrada

userstring
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
limitinteger
Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstring
Offset token.
opt_fieldsstring[]
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_gidstringObligatorio
Globally unique identifier for the workspace.

Parámetros de salida

dataobject[]
List of workspace memberships.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination data for the next page.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Workspace ProjectsASANA_GET_WORKSPACE_PROJECTSAcción

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

Parámetros de entrada

limitinteger
Number of objects to return per page (max 100).
offsetstring
Offset token for pagination.
opt_expandstring[]
Fields to expand in the response.
opt_fieldsstring[]
Fields to include in the response.
workspace_gidstringObligatorio
Globally unique identifier for the workspace.

Parámetros de salida

dataobject[]Obligatorio
List of compact project objects.
errorstring
Error if any occurred during the execution of the action
next_pageobject
Pagination information if more results available.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Insert or Reorder Enum Option for Custom FieldASANA_INSERT_ENUM_OPTION_FOR_CUSTOM_FIELDAcción

Tool to reorder an existing enum option or insert a new enum option for a custom field at a specific position. use when you need to manage the order of options in an enum custom field or add a new option at a defined place.

Parámetros de entrada

dataobjectObligatorio
The data for the enum option to be inserted or reordered.
opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output.
custom_field_gidstringObligatorio
Globally unique identifier for the custom field.

Parámetros de salida

dataobjectObligatorio
The enum option that was created or reordered.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Remove Follower From TaskASANA_REMOVE_FOLLOWER_FROM_TASKAcción

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

Parámetros de entrada

task_gidstringObligatorio
The globally unique identifier for the task.
followersstring[]Obligatorio
An array of user GIDs to remove as followers.

Parámetros de salida

dataobjectObligatorio
The updated task record.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Submit Parallel Requests (Batch API)ASANA_SUBMIT_PARALLEL_REQUESTSAcción

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.

Parámetros de entrada

dataobjectObligatorio
Contains the list of actions to be performed in parallel.

Parámetros de salida

dataobject[]
A list of result objects corresponding to each action in the request.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update AllocationASANA_UPDATE_ALLOCATIONAcción

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.

Parámetros de entrada

dataobjectObligatorio
The data to update the allocation with.
opt_fieldsstring[]
A comma-separated list of fields to include in the response.
opt_prettyboolean
If true, the response will be in a human-readable format.
allocation_gidstringObligatorio
Globally unique identifier for the allocation to be updated.

Parámetros de salida

dataobjectObligatorio
The full updated allocation record.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update a taskASANA_UPDATE_A_TASKAcción

Updates attributes of an existing asana task identified by its task gid.

Parámetros de entrada

dataobjectObligatorio
An object containing the fields of the task to update.
task_gidstringObligatorio
The GID of the task to update.
opt_fieldsstring[]
A list 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.
opt_prettyboolean
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.

Parámetros de salida

dataobjectObligatorio
Contains the full updated task record.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Custom FieldASANA_UPDATE_CUSTOM_FIELDAcción

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.

Parámetros de entrada

dataobjectObligatorio
The data to update the custom field with.
opt_fieldsstring[]
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_prettyboolean
Provides “pretty” output.
custom_field_gidstringObligatorio
Globally unique identifier for the custom field.

Parámetros de salida

dataobjectObligatorio
The full custom field record for the updated custom field.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Enum OptionASANA_UPDATE_ENUM_OPTIONAcción

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.

Parámetros de entrada

dataobjectObligatorio
The data to update the enum option with.
opt_fieldsstring[]
Defines the fields to be returned in the response.
opt_prettyboolean
Provides “pretty” output. Formatting of the result will follow JSON pretty print conventions (line breaks and indentation).
enum_option_gidstringObligatorio
Globally unique identifier for the enum option.

Parámetros de salida

dataobjectObligatorio
The updated enum option.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update a projectASANA_UPDATE_PROJECTAcción

Update a project.

Parámetros de entrada

namestring
The name of the project.
teamstring
The GID of the team that this project is shared with.
colorstring
Color of the project.
notesstring
Free-form textual information associated with the project (its description).
ownerstring
The GID of the new owner of the project. May be null.
due_onstring
The day on which this project is due. This takes a date with format YYYY-MM-DD.
publicboolean
True if the project is public to its team.
archivedboolean
True if the project is archived, false if not.
due_datestring
The localized day on which this project is due. This takes a date with format YYYY-MM-DD.
start_onstring
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_notesstring
[Opt In](/docs/input-output-options). The notes of the project with formatting as HTML.
is_templateboolean
[Opt In](/docs/input-output-options). True if the project is a template.
project_gidstringObligatorio
The GID of the project to update.
default_viewstring
The default view (list, board, calendar, or timeline) of a project.
custom_fieldsobject
An object where each key is the GID of a custom field and its corresponding value is the new value for that custom field.

Parámetros de salida

dataobjectObligatorio
The project object that was updated.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update TagASANA_UPDATE_TAGAcción

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

Parámetros de entrada

dataobjectObligatorio
An object containing the fields to update.
tag_gidstringObligatorio
The globally unique identifier for the tag.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update a teamASANA_UPDATE_TEAMAcción

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

Parámetros de entrada

namestring
The new name of the team.
team_gidstringObligatorio
Globally unique identifier for the team.
opt_fieldsstring[]
Defines fields to return.
opt_prettyboolean
Provides “pretty” output.
descriptionstring
The new description of the team.
organizationstring
GID of the organization to which the team belongs. This is the GID of an organization, not its name.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Triggers (6)

Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).

Attachment Added to TaskASANA_TASK_ATTACHMENT_ADDEDTrigger

Triggers when an attachment is added to a task.

Configuración

project_gidstringObligatorio
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.

Payload del evento

attachment_gidstringObligatorio
GID of the attachment
attachment_subtypestring
Subtype of the attachment (e.g. 'external')
created_atstringObligatorio
Timestamp of the event
task_gidstringObligatorio
GID of the task the attachment was added to
user_gidstring
GID of the user who added the attachment

New Comment on TaskASANA_TASK_COMMENT_ADDEDTrigger

Triggers when a comment is added to a task in a project.

Configuración

project_gidstringObligatorio
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.

Payload del evento

created_atstringObligatorio
Timestamp of the event
story_gidstringObligatorio
GID of the comment story
task_gidstringObligatorio
GID of the task the comment was added to
user_gidstring
GID of the user who posted the comment

New Task CreatedASANA_TASK_CREATEDTrigger

Triggers when a new task is created in a project.

Configuración

project_gidstringObligatorio
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.

Payload del evento

created_atstringObligatorio
Timestamp of the event
project_gidstringObligatorio
GID of the project the task was added to
task_gidstringObligatorio
GID of the created task
user_gidstring
GID of the user who created the task

Task Moved to SectionASANA_TASK_MOVED_TO_SECTIONTrigger

Triggers when a task is moved to a section in a project.

Configuración

project_gidstringObligatorio
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.
section_gidstring
Asana GID of the destination section (numeric string, e.g. '1214062125915600'). Find it via GET /projects/{project_gid}/sections or from the Asana UI section URL. Must be a GID — section names are not accepted. Only triggers when a task is moved to this specific section. If empty, triggers for any section move.

Payload del evento

created_atstringObligatorio
Timestamp of the event
section_gidstringObligatorio
GID of the destination section
task_gidstringObligatorio
GID of the task that was moved
user_gidstring
GID of the user who moved the task

Tag Added to TaskASANA_TASK_TAG_ADDEDTrigger

Triggers when a tag is added to a task. Note: Asana's event structure is inverted for tag events — the resource is the task and the parent is the tag. So parent.gid gives the tag GID.

Configuración

project_gidstringObligatorio
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.
tag_gidstring
Asana GID of the tag (numeric string, e.g. '1214062370176213'). Find it via GET /workspaces/{workspace_gid}/tags. Must be a GID — tag names (e.g. 'urgent') are not accepted. Only triggers when this specific tag is added. If empty, triggers for any tag.

Payload del evento

created_atstringObligatorio
Timestamp of the event
tag_gidstringObligatorio
GID of the tag that was added
task_gidstringObligatorio
GID of the task the tag was added to
user_gidstring
GID of the user who added the tag

Task UpdatedASANA_TASK_UPDATEDTrigger

Triggers when a task is updated in a project.

Configuración

fieldsstring[]
Only trigger when one of these fields changes (e.g. ['assignee', 'due_on', 'name']). If not set, triggers on any field change.
project_gidstringObligatorio
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.

Payload del evento

change_actionstringObligatorio
The change action (e.g. 'changed')
change_fieldstringObligatorio
Name of the field that changed
created_atstringObligatorio
Timestamp of the event
new_valueobject
New value of the field, if available
task_gidstringObligatorio
GID of the updated task
user_gidstring
GID of the user who made the change