How do I install the Asana full reference skill?

Run npx skillmds@latest add tools-only/asana-full-reference in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Asana full reference skill do?

This is the full reference documentation for the Asana agent connector. It is listed under Coding & Dev Tools on SkillMD.

Is Asana full reference safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Asana full reference?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Asana full reference free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Asana full reference?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Asana full reference by tools-only — Agent Skill

Name: Asana full reference
Author: tools-only

Asana full reference

This is the full reference documentation for the Asana agent connector.

Supported entities and actions

The Asana connector supports the following entities and actions.

Entity	Actions
Tasks	List, Get, Search
Project Tasks	List
Workspace Task Search	List
Projects	List, Get, Search
Task Projects	List
Team Projects	List
Workspace Projects	List
Workspaces	List, Get, Search
Users	List, Get, Search
Workspace Users	List
Team Users	List
Teams	Get, Search
Workspace Teams	List
User Teams	List
Attachments	List, Get, Download, Search
Workspace Tags	List
Tags	Get, Search
Project Sections	List
Sections	Get, Search
Task Subtasks	List
Task Dependencies	List
Task Dependents	List

Tasks

Tasks List

Returns a paginated list of tasks. Must include either a project OR a section OR a workspace AND assignee parameter.

Python SDK

await asana.tasks.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "tasks",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token
`project`	`string`	No	The project to filter tasks on
`workspace`	`string`	No	The workspace to filter tasks on
`section`	`string`	No	The workspace to filter tasks on
`assignee`	`string`	No	The assignee to filter tasks on
`completed_since`	`string`	No	Only return tasks that have been completed since this time
`modified_since`	`string`	No	Only return tasks that have been completed since this time

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`
`resource_subtype`	`string`
`created_by`	`object`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Tasks Get

Get a single task by its ID

Python SDK

await asana.tasks.get(
    task_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "tasks",
    "action": "get",
    "params": {
        "task_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`task_gid`	`string`	Yes	Task GID

Records

Field Name	Type	Description
`gid`	`string`

Tasks Search

Search and filter tasks records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await asana.tasks.search(
    query={"filter": {"eq": {"actual_time_minutes": 0}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "tasks",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"actual_time_minutes": 0}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`actual_time_minutes`	`integer`	The actual time spent on the task in minutes
`approval_status`	`string`
`assignee`	`object`
`completed`	`boolean`
`completed_at`	`string`
`completed_by`	`object`
`created_at`	`string`
`custom_fields`	`array`
`dependencies`	`array`
`dependents`	`array`
`due_at`	`string`
`due_on`	`string`
`external`	`object`
`followers`	`array`
`gid`	`string`
`hearted`	`boolean`
`hearts`	`array`
`html_notes`	`string`
`is_rendered_as_separator`	`boolean`
`liked`	`boolean`
`likes`	`array`
`memberships`	`array`
`modified_at`	`string`
`name`	`string`
`notes`	`string`
`num_hearts`	`integer`
`num_likes`	`integer`
`num_subtasks`	`integer`
`parent`	`object`
`permalink_url`	`string`
`projects`	`array`
`resource_subtype`	`string`
`resource_type`	`string`
`start_on`	`string`
`tags`	`array`
`workspace`	`object`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.actual_time_minutes`	`integer`	The actual time spent on the task in minutes
`hits[].data.approval_status`	`string`
`hits[].data.assignee`	`object`
`hits[].data.completed`	`boolean`
`hits[].data.completed_at`	`string`
`hits[].data.completed_by`	`object`
`hits[].data.created_at`	`string`
`hits[].data.custom_fields`	`array`
`hits[].data.dependencies`	`array`
`hits[].data.dependents`	`array`
`hits[].data.due_at`	`string`
`hits[].data.due_on`	`string`
`hits[].data.external`	`object`
`hits[].data.followers`	`array`
`hits[].data.gid`	`string`
`hits[].data.hearted`	`boolean`
`hits[].data.hearts`	`array`
`hits[].data.html_notes`	`string`
`hits[].data.is_rendered_as_separator`	`boolean`
`hits[].data.liked`	`boolean`
`hits[].data.likes`	`array`
`hits[].data.memberships`	`array`
`hits[].data.modified_at`	`string`
`hits[].data.name`	`string`
`hits[].data.notes`	`string`
`hits[].data.num_hearts`	`integer`
`hits[].data.num_likes`	`integer`
`hits[].data.num_subtasks`	`integer`
`hits[].data.parent`	`object`
`hits[].data.permalink_url`	`string`
`hits[].data.projects`	`array`
`hits[].data.resource_subtype`	`string`
`hits[].data.resource_type`	`string`
`hits[].data.start_on`	`string`
`hits[].data.tags`	`array`
`hits[].data.workspace`	`object`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Project Tasks

Project Tasks List

Returns all tasks in a project

Python SDK

await asana.project_tasks.list(
    project_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "project_tasks",
    "action": "list",
    "params": {
        "project_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`project_gid`	`string`	Yes	Project GID to list tasks from
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token
`completed_since`	`string`	No	Only return tasks that have been completed since this time

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`
`resource_subtype`	`string`
`created_by`	`object`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Workspace Task Search

Workspace Task Search List

Returns tasks that match the specified search criteria. This endpoint requires a premium Asana account.

IMPORTANT: At least one search filter parameter must be provided. Valid filter parameters include: text, completed, assignee.any, projects.any, sections.any, teams.any, followers.any, created_at.after, created_at.before, modified_at.after, modified_at.before, due_on.after, due_on.before, and resource_subtype. The sort_by and sort_ascending parameters are for ordering results and do not count as search filters.

Python SDK

await asana.workspace_task_search.list(
    workspace_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "workspace_task_search",
    "action": "list",
    "params": {
        "workspace_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`workspace_gid`	`string`	Yes	Workspace GID to search tasks in
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token
`text`	`string`	No	Search text to filter tasks
`completed`	`boolean`	No	Filter by completion status
`assignee.any`	`string`	No	Comma-separated list of assignee GIDs
`projects.any`	`string`	No	Comma-separated list of project GIDs
`sections.any`	`string`	No	Comma-separated list of section GIDs
`teams.any`	`string`	No	Comma-separated list of team GIDs
`followers.any`	`string`	No	Comma-separated list of follower GIDs
`created_at.after`	`string`	No	Filter tasks created after this date (ISO 8601 format)
`created_at.before`	`string`	No	Filter tasks created before this date (ISO 8601 format)
`modified_at.after`	`string`	No	Filter tasks modified after this date (ISO 8601 format)
`modified_at.before`	`string`	No	Filter tasks modified before this date (ISO 8601 format)
`due_on.after`	`string`	No	Filter tasks due after this date (ISO 8601 date format)
`due_on.before`	`string`	No	Filter tasks due before this date (ISO 8601 date format)
`resource_subtype`	`string`	No	Filter by task resource subtype (e.g., default_task, milestone)
`sort_by`	`string`	No	Field to sort by (e.g., created_at, modified_at, due_date)
`sort_ascending`	`boolean`	No	Sort order (true for ascending, false for descending)

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`
`resource_subtype`	`string`
`created_by`	`object`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Projects

Projects List

Returns a paginated list of projects

Python SDK

await asana.projects.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "projects",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token
`workspace`	`string`	No	The workspace to filter projects on
`team`	`string`	No	The team to filter projects on
`archived`	`boolean`	No	Filter by archived status

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Projects Get

Get a single project by its ID

Python SDK

await asana.projects.get(
    project_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "projects",
    "action": "get",
    "params": {
        "project_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`project_gid`	`string`	Yes	Project GID

Records

Field Name	Type	Description
`gid`	`string`
`archived`	`boolean`
`color`	`string \| null`
`completed`	`boolean`
`completed_at`	`string \| null`
`created_at`	`string`
`current_status`	`object \| null`
`current_status_update`	`object \| null`
`custom_fields`	`array`
`default_access_level`	`string`
`default_view`	`string`
`due_on`	`string \| null`
`due_date`	`string \| null`
`followers`	`array<object>`
`members`	`array<object>`
`minimum_access_level_for_customization`	`string`
`minimum_access_level_for_sharing`	`string`
`modified_at`	`string`
`name`	`string`
`notes`	`string`
`owner`	`object`
`permalink_url`	`string`
`privacy_setting`	`string`
`public`	`boolean`
`resource_type`	`string`
`start_on`	`string \| null`
`team`	`object`
`workspace`	`object`

Projects Search

Search and filter projects records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await asana.projects.search(
    query={"filter": {"eq": {"archived": True}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "projects",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"archived": True}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`archived`	`boolean`
`color`	`string`
`created_at`	`string`
`current_status`	`object`
`custom_field_settings`	`array`
`custom_fields`	`array`
`default_view`	`string`
`due_date`	`string`
`due_on`	`string`
`followers`	`array`
`gid`	`string`
`html_notes`	`string`
`icon`	`string`
`is_template`	`boolean`
`members`	`array`
`modified_at`	`string`
`name`	`string`
`notes`	`string`
`owner`	`object`
`permalink_url`	`string`
`public`	`boolean`
`resource_type`	`string`
`start_on`	`string`
`team`	`object`
`workspace`	`object`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.archived`	`boolean`
`hits[].data.color`	`string`
`hits[].data.created_at`	`string`
`hits[].data.current_status`	`object`
`hits[].data.custom_field_settings`	`array`
`hits[].data.custom_fields`	`array`
`hits[].data.default_view`	`string`
`hits[].data.due_date`	`string`
`hits[].data.due_on`	`string`
`hits[].data.followers`	`array`
`hits[].data.gid`	`string`
`hits[].data.html_notes`	`string`
`hits[].data.icon`	`string`
`hits[].data.is_template`	`boolean`
`hits[].data.members`	`array`
`hits[].data.modified_at`	`string`
`hits[].data.name`	`string`
`hits[].data.notes`	`string`
`hits[].data.owner`	`object`
`hits[].data.permalink_url`	`string`
`hits[].data.public`	`boolean`
`hits[].data.resource_type`	`string`
`hits[].data.start_on`	`string`
`hits[].data.team`	`object`
`hits[].data.workspace`	`object`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Task Projects

Task Projects List

Returns all projects a task is in

Python SDK

await asana.task_projects.list(
    task_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "task_projects",
    "action": "list",
    "params": {
        "task_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`task_gid`	`string`	Yes	Task GID to list projects from
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Team Projects

Team Projects List

Returns all projects for a team

Python SDK

await asana.team_projects.list(
    team_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "team_projects",
    "action": "list",
    "params": {
        "team_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`team_gid`	`string`	Yes	Team GID to list projects from
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token
`archived`	`boolean`	No	Filter by archived status

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Workspace Projects

Workspace Projects List

Returns all projects in a workspace

Python SDK

await asana.workspace_projects.list(
    workspace_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "workspace_projects",
    "action": "list",
    "params": {
        "workspace_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`workspace_gid`	`string`	Yes	Workspace GID to list projects from
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token
`archived`	`boolean`	No	Filter by archived status

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Workspaces

Workspaces List

Returns a paginated list of workspaces

Python SDK

await asana.workspaces.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "workspaces",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Workspaces Get

Get a single workspace by its ID

Python SDK

await asana.workspaces.get(
    workspace_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "workspaces",
    "action": "get",
    "params": {
        "workspace_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`workspace_gid`	`string`	Yes	Workspace GID

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`
`email_domains`	`array<string>`
`is_organization`	`boolean`

Workspaces Search

Search and filter workspaces records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await asana.workspaces.search(
    query={"filter": {"eq": {"email_domains": []}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "workspaces",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"email_domains": []}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`email_domains`	`array`
`gid`	`string`
`is_organization`	`boolean`
`name`	`string`
`resource_type`	`string`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.email_domains`	`array`
`hits[].data.gid`	`string`
`hits[].data.is_organization`	`boolean`
`hits[].data.name`	`string`
`hits[].data.resource_type`	`string`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Users

Users List

Returns a paginated list of users

Python SDK

await asana.users.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token
`workspace`	`string`	No	The workspace to filter users on
`team`	`string`	No	The team to filter users on

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Users Get

Get a single user by their ID

Python SDK

await asana.users.get(
    user_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "get",
    "params": {
        "user_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`user_gid`	`string`	Yes	User GID

Records

Field Name	Type	Description
`gid`	`string`
`email`	`string`
`name`	`string`
`photo`	`object \| null`
`resource_type`	`string`
`workspaces`	`array<object>`

Users Search

Search and filter users records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await asana.users.search(
    query={"filter": {"eq": {"email": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"email": "<str>"}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`email`	`string`
`gid`	`string`
`name`	`string`
`photo`	`object`
`resource_type`	`string`
`workspaces`	`array`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.email`	`string`
`hits[].data.gid`	`string`
`hits[].data.name`	`string`
`hits[].data.photo`	`object`
`hits[].data.resource_type`	`string`
`hits[].data.workspaces`	`array`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Workspace Users

Workspace Users List

Returns all users in a workspace

Python SDK

await asana.workspace_users.list(
    workspace_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "workspace_users",
    "action": "list",
    "params": {
        "workspace_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`workspace_gid`	`string`	Yes	Workspace GID to list users from
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Team Users

Team Users List

Returns all users in a team

Python SDK

await asana.team_users.list(
    team_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "team_users",
    "action": "list",
    "params": {
        "team_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`team_gid`	`string`	Yes	Team GID to list users from
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

Teams

Teams Get

Get a single team by its ID

Python SDK

await asana.teams.get(
    team_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "teams",
    "action": "get",
    "params": {
        "team_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`team_gid`	`string`	Yes	Team GID

Records

Field Name	Type	Description
`gid`	`string`
`name`	`string`
`organization`	`object`
`permalink_url`	`string`
`resource_type`	`string`

Teams Search

Search and filter teams records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await asana.teams.search(
    query={"filter": {"eq": {"description": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "teams",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"description": "<str>"}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`description`	`string`
`gid`	`string`
`html_description`	`string`
`name`	`string`
`organization`	`object`
`permalink_url`	`string`
`resource_type`	`string`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.description`	`string`
`hits[].data.gid`	`string`
`hits[].data.html_description`	`string`
`hits[].data.name`	`string`
`hits[].data.organization`	`object`
`hits[].data.permalink_url`	`string`
`hits[].data.resource_type`	`string`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Workspace Teams

Workspace Teams List

Returns all teams in a workspace

Python SDK

await asana.workspace_teams.list(
    workspace_gid="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "workspace_teams",
    "action": "list",
    "params": {
        "workspace_gid": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`workspace_gid`	`string`	Yes	Workspace GID to list teams from
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token

Records

Field Name	Type	Description
`gid`	`string`
`resource_type`	`string`
`name`	`string`

Meta

Field Name	Type	Description
`next_page`	`object \| null`

User Teams

User Teams List

Returns all teams a user is a member of

Python SDK

await asana.user_teams.list(
    user_gid="<str>",
    organization="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "user_teams",
    "action": "list",
    "params": {
        "user_gid": "<str>",
        "organization": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`user_gid`	`string`	Yes	User GID to list teams from
`organization`	`string`	Yes	The workspace or organization to filter teams on
`limit`	`integer`	No	Number of items to return per page
`offset`	`string`	No	Pagination offset token

<detail

…(truncated)

Asana full reference

File contents

Asana full reference

Supported entities and actions

Tasks

Tasks List

Python SDK

API

Parameters

Records

Meta

Tasks Get

Python SDK

API

Parameters

Records

Tasks Search

Python SDK

API

Parameters

Searchable Fields

Project Tasks

Project Tasks List

Python SDK

API

Parameters

Records

Meta

Workspace Task Search

Workspace Task Search List

Python SDK

API

Parameters

Records

Meta

Projects

Projects List

Python SDK

API

Parameters

Records

Meta

Projects Get

Python SDK

API

Parameters

Records

Projects Search

Python SDK

API

Parameters

Searchable Fields

Task Projects

Task Projects List

Python SDK

API

Parameters

Records

Meta

Team Projects

Team Projects List

Python SDK

API

Parameters

Records

Meta

Workspace Projects

Workspace Projects List

Python SDK

API

Parameters

Records

Meta

Workspaces

Workspaces List

Python SDK

API

Parameters

Records

Meta