Asana

Supported Entities and Actions

Entity	Actions
Tasks	List, Get
Project Tasks	List
Workspace Task Search	List
Projects	List, Get
Task Projects	List
Team Projects	List
Workspace Projects	List
Workspaces	List, Get
Users	List, Get
Workspace Users	List
Team Users	List
Teams	Get
Workspace Teams	List
User Teams	List

Tasks

Tasks List

Returns a paginated list of tasks

Python SDK

asana.tasks.list()

API

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

Params

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

Response Schema

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

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

API

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

Params

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

Response Schema

Records

Field Name	Type	Description
`gid`	`string`

Project Tasks

Project Tasks List

Returns all tasks in a project

Python SDK

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

API

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

Params

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

Response Schema

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. Note - This endpoint requires a premium Asana account.

Python SDK

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

API

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

Params

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)

Response Schema

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

asana.projects.list()

API

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

Params

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

Response Schema

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

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

API

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

Params

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

Response Schema

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`

Task Projects

Task Projects List

Returns all projects a task is in

Python SDK

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

API

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

Params

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

Response Schema

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

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

API

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

Params

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

Response Schema

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

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

API

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

Params

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

Response Schema

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

asana.workspaces.list()

API

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

Params

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

Response Schema

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

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

API

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

Params

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

Response Schema

Records

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

Users

Users List

Returns a paginated list of users

Python SDK

asana.users.list()

API

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

Params

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

Response Schema

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

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

API

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

Params

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

Response Schema

Records

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

Workspace Users

Workspace Users List

Returns all users in a workspace

Python SDK

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

API

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

Params

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

Response Schema

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

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

API

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

Params

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

Response Schema

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

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

API

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

Params

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

Response Schema

Records

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

Workspace Teams

Workspace Teams List

Returns all teams in a workspace

Python SDK

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

API

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

Params

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

Response Schema

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

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

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_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>"
    }
}'

Params

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

Response Schema

Records

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

Meta

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

Authentication

The Asana connector supports the following authentication methods:

Asana OAuth 2.0

Field Name	Type	Required	Description
`access_token`	`str`	Yes	OAuth access token for API requests
`refresh_token`	`str`	Yes	OAuth refresh token for automatic token renewal
`client_id`	`str`	Yes	Connected App Consumer Key
`client_secret`	`str`	Yes	Connected App Consumer Secret

Example

Python SDK

AsanaConnector(
  auth_config=AsanaAuthConfig(
    access_token="<OAuth access token for API requests>",
    refresh_token="<OAuth refresh token for automatic token renewal>",
    client_id="<Connected App Consumer Key>",
    client_secret="<Connected App Consumer Secret>"
  )
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
  "connector_definition_id": "d0243522-dccf-4978-8ba0-37ed47a0bdbf",
  "auth_config": {
    "access_token": "<OAuth access token for API requests>",
    "refresh_token": "<OAuth refresh token for automatic token renewal>",
    "client_id": "<Connected App Consumer Key>",
    "client_secret": "<Connected App Consumer Secret>"
  },
  "name": "My Asana Connector"
}'

Supported Entities and Actions​

Tasks​

Tasks List​

Tasks Get​

Project Tasks​

Project Tasks List​

Workspace Task Search​

Workspace Task Search List​

Projects​

Projects List​

Projects Get​

Task Projects​

Task Projects List​

Team Projects​

Team Projects List​

Workspace Projects​

Workspace Projects List​

Workspaces​

Workspaces List​

Workspaces Get​

Users​

Users List​

Users Get​

Workspace Users​

Workspace Users List​

Team Users​

Team Users List​

Teams​

Teams Get​

Workspace Teams​

Workspace Teams List​

User Teams​

User Teams List​

Authentication​

Asana OAuth 2.0​

Example​

Supported Entities and Actions

Tasks

Tasks List

Tasks Get

Project Tasks

Project Tasks List

Workspace Task Search

Workspace Task Search List

Projects

Projects List

Projects Get

Task Projects

Task Projects List

Team Projects

Team Projects List

Workspace Projects

Workspace Projects List

Workspaces

Workspaces List

Workspaces Get

Users

Users List

Users Get

Workspace Users

Workspace Users List

Team Users

Team Users List

Teams

Teams Get

Workspace Teams

Workspace Teams List

User Teams

User Teams List

Authentication

Asana OAuth 2.0

Example