{"author":"Asana, Inc","author_email":null,"bugtrack_url":null,"classifiers":[],"description":"# asana [![GitHub release][release-image]]() [![PyPi Version][pypi-image]][pypi-url]\n\n- API version: 1.0\n- Package version: 5.1.0\n\n## Requirements.\n\nPython 3.4+\n\n## Installation & Usage\n### pip install from [PyPI](https://pypi.org/project/asana/)\n\n```sh\npip install asana\n```\n\nThen import the package:\n```python\nimport asana \n```\n\n### Setuptools\n\nInstall via [Setuptools](http://pypi.python.org/pypi/setuptools).\n\n```sh\npython setup.py install --user\n```\n(or `sudo python setup.py install` to install the package for all users)\n\nThen import the package:\n```python\nimport asana\n```\n\n## Getting Started\n\nPlease follow the [installation procedure](#installation--usage) and then run the following:\n\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\n# create an instance of the API class\nusers_api_instance = asana.UsersApi(api_client)\nuser_gid = \"me\"\nopts = {}\n\ntry:\n # Get a user\n user = users_api_instance.get_user(user_gid, opts)\n pprint(user)\nexcept ApiException as e:\n print(\"Exception when calling UsersApi->get_user: %s\\n\" % e)\n```\n\n### Example: GET, POST, PUT, DELETE on tasks\n\n#### GET - get multiple tasks\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\n# create an instance of the API class\ntasks_api_instance = asana.TasksApi(api_client)\nopts = { \n 'limit': 50,\n 'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\",\n 'assignee': \"14641\",\n 'project': \"321654\",\n 'section': \"321654\",\n 'workspace': \"321654\",\n 'completed_since': '2012-02-22T02:06:58.158Z',\n 'modified_since': '2012-02-22T02:06:58.158Z',\n 'opt_fields': \"actual_time_minutes,approval_status,assignee,assignee.name,assignee_section,assignee_section.name,assignee_status,completed,completed_at,completed_by,completed_by.name,created_at,created_by,custom_fields,custom_fields.asana_created_field,custom_fields.created_by,custom_fields.created_by.name,custom_fields.currency_code,custom_fields.custom_label,custom_fields.custom_label_position,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.description,custom_fields.display_value,custom_fields.enabled,custom_fields.enum_options,custom_fields.enum_options.color,custom_fields.enum_options.enabled,custom_fields.enum_options.name,custom_fields.enum_value,custom_fields.enum_value.color,custom_fields.enum_value.enabled,custom_fields.enum_value.name,custom_fields.format,custom_fields.has_notifications_enabled,custom_fields.is_formula_field,custom_fields.is_global_to_workspace,custom_fields.is_value_read_only,custom_fields.multi_enum_values,custom_fields.multi_enum_values.color,custom_fields.multi_enum_values.enabled,custom_fields.multi_enum_values.name,custom_fields.name,custom_fields.number_value,custom_fields.people_value,custom_fields.people_value.name,custom_fields.precision,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,dependencies,dependents,due_at,due_on,external,external.data,followers,followers.name,hearted,hearts,hearts.user,hearts.user.name,html_notes,is_rendered_as_separator,liked,likes,likes.user,likes.user.name,memberships,memberships.project,memberships.project.name,memberships.section,memberships.section.name,modified_at,name,notes,num_hearts,num_likes,num_subtasks,offset,parent,parent.created_by,parent.name,parent.resource_subtype,path,permalink_url,projects,projects.name,resource_subtype,start_at,start_on,tags,tags.name,uri,workspace,workspace.name\"\n}\n\ntry:\n # Get multiple tasks\n tasks = tasks_api_instance.get_tasks(opts)\n for task in tasks:\n pprint(task)\nexcept ApiException as e:\n print(\"Exception when calling TasksApi->get_tasks: %s\\n\" % e)\n```\n\n#### POST - create a task\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\n# create an instance of the API class\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\n \"data\": {\n \"name\": \"New Task\",\n \"projects\": [\"\"],\n }\n}\nopts = {}\n\ntry:\n # Create a task\n task = tasks_api_instance.create_task(body, opts)\n pprint(task)\nexcept ApiException as e:\n print(\"Exception when calling TasksApi->create_task: %s\\n\" % e)\n```\n\n#### PUT - update a task\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\n# create an instance of the API class\ntasks_api_instance = asana.TasksApi(api_client)\nbody = {\n \"data\": {\n \"name\": \"Updated Task\",\n }\n}\ntask_gid = \"\"\nopts = {}\n\ntry:\n # Update a task\n task = tasks_api_instance.update_task(body, task_gid, opts)\n pprint(task)\nexcept ApiException as e:\n print(\"Exception when calling TasksApi->update_task: %s\\n\" % e)\n```\n\n#### DELETE - delete a task\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\n# create an instance of the API class\ntasks_api_instance = asana.TasksApi(api_client)\ntask_gid = \"\"\n\ntry:\n # Delete a task\n task = tasks_api_instance.delete_task(task_gid)\n pprint(task)\nexcept ApiException as e:\n print(\"Exception when calling TasksApi->delete_task: %s\\n\" % e)\n```\n\n## Documentation for API Endpoints\n\nAll URIs are relative to *https://app.asana.com/api/1.0*\n\nClass | Method | HTTP request | Description\n------------ | ------------- | ------------- | -------------\n*AllocationsApi* | [**create_allocation**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AllocationsApi.md#create_allocation) | **POST** /allocations | Create an allocation\n*AllocationsApi* | [**delete_allocation**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AllocationsApi.md#delete_allocation) | **DELETE** /allocations/{allocation_gid} | Delete an allocation\n*AllocationsApi* | [**get_allocation**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AllocationsApi.md#get_allocation) | **GET** /allocations/{allocation_gid} | Get an allocation\n*AllocationsApi* | [**get_allocations**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AllocationsApi.md#get_allocations) | **GET** /allocations | Get multiple allocations\n*AllocationsApi* | [**update_allocation**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AllocationsApi.md#update_allocation) | **PUT** /allocations/{allocation_gid} | Update an allocation\n*AttachmentsApi* | [**create_attachment_for_object**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AttachmentsApi.md#create_attachment_for_object) | **POST** /attachments | Upload an attachment\n*AttachmentsApi* | [**delete_attachment**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AttachmentsApi.md#delete_attachment) | **DELETE** /attachments/{attachment_gid} | Delete an attachment\n*AttachmentsApi* | [**get_attachment**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AttachmentsApi.md#get_attachment) | **GET** /attachments/{attachment_gid} | Get an attachment\n*AttachmentsApi* | [**get_attachments_for_object**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AttachmentsApi.md#get_attachments_for_object) | **GET** /attachments | Get attachments from an object\n*AuditLogAPIApi* | [**get_audit_log_events**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/AuditLogAPIApi.md#get_audit_log_events) | **GET** /workspaces/{workspace_gid}/audit_log_events | Get audit log events\n*BatchAPIApi* | [**create_batch_request**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/BatchAPIApi.md#create_batch_request) | **POST** /batch | Submit parallel requests\n*CustomFieldSettingsApi* | [**get_custom_field_settings_for_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldSettingsApi.md#get_custom_field_settings_for_portfolio) | **GET** /portfolios/{portfolio_gid}/custom_field_settings | Get a portfolio's custom fields\n*CustomFieldSettingsApi* | [**get_custom_field_settings_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldSettingsApi.md#get_custom_field_settings_for_project) | **GET** /projects/{project_gid}/custom_field_settings | Get a project's custom fields\n*CustomFieldsApi* | [**create_custom_field**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldsApi.md#create_custom_field) | **POST** /custom_fields | Create a custom field\n*CustomFieldsApi* | [**create_enum_option_for_custom_field**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldsApi.md#create_enum_option_for_custom_field) | **POST** /custom_fields/{custom_field_gid}/enum_options | Create an enum option\n*CustomFieldsApi* | [**delete_custom_field**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldsApi.md#delete_custom_field) | **DELETE** /custom_fields/{custom_field_gid} | Delete a custom field\n*CustomFieldsApi* | [**get_custom_field**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldsApi.md#get_custom_field) | **GET** /custom_fields/{custom_field_gid} | Get a custom field\n*CustomFieldsApi* | [**get_custom_fields_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldsApi.md#get_custom_fields_for_workspace) | **GET** /workspaces/{workspace_gid}/custom_fields | Get a workspace's custom fields\n*CustomFieldsApi* | [**insert_enum_option_for_custom_field**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldsApi.md#insert_enum_option_for_custom_field) | **POST** /custom_fields/{custom_field_gid}/enum_options/insert | Reorder a custom field's enum\n*CustomFieldsApi* | [**update_custom_field**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldsApi.md#update_custom_field) | **PUT** /custom_fields/{custom_field_gid} | Update a custom field\n*CustomFieldsApi* | [**update_enum_option**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomFieldsApi.md#update_enum_option) | **PUT** /enum_options/{enum_option_gid} | Update an enum option\n*CustomTypesApi* | [**get_custom_types**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/CustomTypesApi.md#get_custom_types) | **GET** /custom_types | Get all custom types associated with an object\n*EventsApi* | [**get_events**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/EventsApi.md#get_events) | **GET** /events | Get events on a resource\n*GoalRelationshipsApi* | [**add_supporting_relationship**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalRelationshipsApi.md#add_supporting_relationship) | **POST** /goals/{goal_gid}/addSupportingRelationship | Add a supporting goal relationship\n*GoalRelationshipsApi* | [**get_goal_relationship**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalRelationshipsApi.md#get_goal_relationship) | **GET** /goal_relationships/{goal_relationship_gid} | Get a goal relationship\n*GoalRelationshipsApi* | [**get_goal_relationships**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalRelationshipsApi.md#get_goal_relationships) | **GET** /goal_relationships | Get goal relationships\n*GoalRelationshipsApi* | [**remove_supporting_relationship**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalRelationshipsApi.md#remove_supporting_relationship) | **POST** /goals/{goal_gid}/removeSupportingRelationship | Removes a supporting goal relationship\n*GoalRelationshipsApi* | [**update_goal_relationship**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalRelationshipsApi.md#update_goal_relationship) | **PUT** /goal_relationships/{goal_relationship_gid} | Update a goal relationship\n*GoalsApi* | [**add_followers**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#add_followers) | **POST** /goals/{goal_gid}/addFollowers | Add a collaborator to a goal\n*GoalsApi* | [**create_goal**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#create_goal) | **POST** /goals | Create a goal\n*GoalsApi* | [**create_goal_metric**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#create_goal_metric) | **POST** /goals/{goal_gid}/setMetric | Create a goal metric\n*GoalsApi* | [**delete_goal**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#delete_goal) | **DELETE** /goals/{goal_gid} | Delete a goal\n*GoalsApi* | [**get_goal**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#get_goal) | **GET** /goals/{goal_gid} | Get a goal\n*GoalsApi* | [**get_goals**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#get_goals) | **GET** /goals | Get goals\n*GoalsApi* | [**get_parent_goals_for_goal**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#get_parent_goals_for_goal) | **GET** /goals/{goal_gid}/parentGoals | Get parent goals from a goal\n*GoalsApi* | [**remove_followers**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#remove_followers) | **POST** /goals/{goal_gid}/removeFollowers | Remove a collaborator from a goal\n*GoalsApi* | [**update_goal**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#update_goal) | **PUT** /goals/{goal_gid} | Update a goal\n*GoalsApi* | [**update_goal_metric**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/GoalsApi.md#update_goal_metric) | **POST** /goals/{goal_gid}/setMetricCurrentValue | Update a goal metric\n*JobsApi* | [**get_job**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/JobsApi.md#get_job) | **GET** /jobs/{job_gid} | Get a job by id\n*MembershipsApi* | [**create_membership**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/MembershipsApi.md#create_membership) | **POST** /memberships | Create a membership\n*MembershipsApi* | [**delete_membership**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/MembershipsApi.md#delete_membership) | **DELETE** /memberships/{membership_gid} | Delete a membership\n*MembershipsApi* | [**get_membership**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/MembershipsApi.md#get_membership) | **GET** /memberships/{membership_gid} | Get a membership\n*MembershipsApi* | [**get_memberships**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/MembershipsApi.md#get_memberships) | **GET** /memberships | Get multiple memberships\n*MembershipsApi* | [**update_membership**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/MembershipsApi.md#update_membership) | **PUT** /memberships/{membership_gid} | Update a membership\n*OrganizationExportsApi* | [**create_organization_export**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/OrganizationExportsApi.md#create_organization_export) | **POST** /organization_exports | Create an organization export request\n*OrganizationExportsApi* | [**get_organization_export**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/OrganizationExportsApi.md#get_organization_export) | **GET** /organization_exports/{organization_export_gid} | Get details on an org export request\n*PortfolioMembershipsApi* | [**get_portfolio_membership**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfolioMembershipsApi.md#get_portfolio_membership) | **GET** /portfolio_memberships/{portfolio_membership_gid} | Get a portfolio membership\n*PortfolioMembershipsApi* | [**get_portfolio_memberships**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfolioMembershipsApi.md#get_portfolio_memberships) | **GET** /portfolio_memberships | Get multiple portfolio memberships\n*PortfolioMembershipsApi* | [**get_portfolio_memberships_for_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfolioMembershipsApi.md#get_portfolio_memberships_for_portfolio) | **GET** /portfolios/{portfolio_gid}/portfolio_memberships | Get memberships from a portfolio\n*PortfoliosApi* | [**add_custom_field_setting_for_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#add_custom_field_setting_for_portfolio) | **POST** /portfolios/{portfolio_gid}/addCustomFieldSetting | Add a custom field to a portfolio\n*PortfoliosApi* | [**add_item_for_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#add_item_for_portfolio) | **POST** /portfolios/{portfolio_gid}/addItem | Add a portfolio item\n*PortfoliosApi* | [**add_members_for_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#add_members_for_portfolio) | **POST** /portfolios/{portfolio_gid}/addMembers | Add users to a portfolio\n*PortfoliosApi* | [**create_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#create_portfolio) | **POST** /portfolios | Create a portfolio\n*PortfoliosApi* | [**delete_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#delete_portfolio) | **DELETE** /portfolios/{portfolio_gid} | Delete a portfolio\n*PortfoliosApi* | [**get_items_for_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#get_items_for_portfolio) | **GET** /portfolios/{portfolio_gid}/items | Get portfolio items\n*PortfoliosApi* | [**get_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#get_portfolio) | **GET** /portfolios/{portfolio_gid} | Get a portfolio\n*PortfoliosApi* | [**get_portfolios**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#get_portfolios) | **GET** /portfolios | Get multiple portfolios\n*PortfoliosApi* | [**remove_custom_field_setting_for_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#remove_custom_field_setting_for_portfolio) | **POST** /portfolios/{portfolio_gid}/removeCustomFieldSetting | Remove a custom field from a portfolio\n*PortfoliosApi* | [**remove_item_for_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#remove_item_for_portfolio) | **POST** /portfolios/{portfolio_gid}/removeItem | Remove a portfolio item\n*PortfoliosApi* | [**remove_members_for_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#remove_members_for_portfolio) | **POST** /portfolios/{portfolio_gid}/removeMembers | Remove users from a portfolio\n*PortfoliosApi* | [**update_portfolio**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/PortfoliosApi.md#update_portfolio) | **PUT** /portfolios/{portfolio_gid} | Update a portfolio\n*ProjectBriefsApi* | [**create_project_brief**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectBriefsApi.md#create_project_brief) | **POST** /projects/{project_gid}/project_briefs | Create a project brief\n*ProjectBriefsApi* | [**delete_project_brief**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectBriefsApi.md#delete_project_brief) | **DELETE** /project_briefs/{project_brief_gid} | Delete a project brief\n*ProjectBriefsApi* | [**get_project_brief**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectBriefsApi.md#get_project_brief) | **GET** /project_briefs/{project_brief_gid} | Get a project brief\n*ProjectBriefsApi* | [**update_project_brief**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectBriefsApi.md#update_project_brief) | **PUT** /project_briefs/{project_brief_gid} | Update a project brief\n*ProjectMembershipsApi* | [**get_project_membership**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectMembershipsApi.md#get_project_membership) | **GET** /project_memberships/{project_membership_gid} | Get a project membership\n*ProjectMembershipsApi* | [**get_project_memberships_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectMembershipsApi.md#get_project_memberships_for_project) | **GET** /projects/{project_gid}/project_memberships | Get memberships from a project\n*ProjectStatusesApi* | [**create_project_status_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectStatusesApi.md#create_project_status_for_project) | **POST** /projects/{project_gid}/project_statuses | Create a project status\n*ProjectStatusesApi* | [**delete_project_status**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectStatusesApi.md#delete_project_status) | **DELETE** /project_statuses/{project_status_gid} | Delete a project status\n*ProjectStatusesApi* | [**get_project_status**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectStatusesApi.md#get_project_status) | **GET** /project_statuses/{project_status_gid} | Get a project status\n*ProjectStatusesApi* | [**get_project_statuses_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectStatusesApi.md#get_project_statuses_for_project) | **GET** /projects/{project_gid}/project_statuses | Get statuses from a project\n*ProjectTemplatesApi* | [**delete_project_template**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectTemplatesApi.md#delete_project_template) | **DELETE** /project_templates/{project_template_gid} | Delete a project template\n*ProjectTemplatesApi* | [**get_project_template**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectTemplatesApi.md#get_project_template) | **GET** /project_templates/{project_template_gid} | Get a project template\n*ProjectTemplatesApi* | [**get_project_templates**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectTemplatesApi.md#get_project_templates) | **GET** /project_templates | Get multiple project templates\n*ProjectTemplatesApi* | [**get_project_templates_for_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectTemplatesApi.md#get_project_templates_for_team) | **GET** /teams/{team_gid}/project_templates | Get a team's project templates\n*ProjectTemplatesApi* | [**instantiate_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectTemplatesApi.md#instantiate_project) | **POST** /project_templates/{project_template_gid}/instantiateProject | Instantiate a project from a project template\n*ProjectsApi* | [**add_custom_field_setting_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#add_custom_field_setting_for_project) | **POST** /projects/{project_gid}/addCustomFieldSetting | Add a custom field to a project\n*ProjectsApi* | [**add_followers_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#add_followers_for_project) | **POST** /projects/{project_gid}/addFollowers | Add followers to a project\n*ProjectsApi* | [**add_members_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#add_members_for_project) | **POST** /projects/{project_gid}/addMembers | Add users to a project\n*ProjectsApi* | [**create_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#create_project) | **POST** /projects | Create a project\n*ProjectsApi* | [**create_project_for_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#create_project_for_team) | **POST** /teams/{team_gid}/projects | Create a project in a team\n*ProjectsApi* | [**create_project_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#create_project_for_workspace) | **POST** /workspaces/{workspace_gid}/projects | Create a project in a workspace\n*ProjectsApi* | [**delete_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#delete_project) | **DELETE** /projects/{project_gid} | Delete a project\n*ProjectsApi* | [**duplicate_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#duplicate_project) | **POST** /projects/{project_gid}/duplicate | Duplicate a project\n*ProjectsApi* | [**get_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#get_project) | **GET** /projects/{project_gid} | Get a project\n*ProjectsApi* | [**get_projects**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#get_projects) | **GET** /projects | Get multiple projects\n*ProjectsApi* | [**get_projects_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#get_projects_for_task) | **GET** /tasks/{task_gid}/projects | Get projects a task is in\n*ProjectsApi* | [**get_projects_for_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#get_projects_for_team) | **GET** /teams/{team_gid}/projects | Get a team's projects\n*ProjectsApi* | [**get_projects_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#get_projects_for_workspace) | **GET** /workspaces/{workspace_gid}/projects | Get all projects in a workspace\n*ProjectsApi* | [**get_task_counts_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#get_task_counts_for_project) | **GET** /projects/{project_gid}/task_counts | Get task count of a project\n*ProjectsApi* | [**project_save_as_template**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#project_save_as_template) | **POST** /projects/{project_gid}/saveAsTemplate | Create a project template from a project\n*ProjectsApi* | [**remove_custom_field_setting_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#remove_custom_field_setting_for_project) | **POST** /projects/{project_gid}/removeCustomFieldSetting | Remove a custom field from a project\n*ProjectsApi* | [**remove_followers_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#remove_followers_for_project) | **POST** /projects/{project_gid}/removeFollowers | Remove followers from a project\n*ProjectsApi* | [**remove_members_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#remove_members_for_project) | **POST** /projects/{project_gid}/removeMembers | Remove users from a project\n*ProjectsApi* | [**update_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#update_project) | **PUT** /projects/{project_gid} | Update a project\n*RulesApi* | [**trigger_rule**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/RulesApi.md#trigger_rule) | **POST** /rule_triggers/{rule_trigger_gid}/run | Trigger a rule\n*SectionsApi* | [**add_task_for_section**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/SectionsApi.md#add_task_for_section) | **POST** /sections/{section_gid}/addTask | Add task to section\n*SectionsApi* | [**create_section_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/SectionsApi.md#create_section_for_project) | **POST** /projects/{project_gid}/sections | Create a section in a project\n*SectionsApi* | [**delete_section**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/SectionsApi.md#delete_section) | **DELETE** /sections/{section_gid} | Delete a section\n*SectionsApi* | [**get_section**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/SectionsApi.md#get_section) | **GET** /sections/{section_gid} | Get a section\n*SectionsApi* | [**get_sections_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/SectionsApi.md#get_sections_for_project) | **GET** /projects/{project_gid}/sections | Get sections in a project\n*SectionsApi* | [**insert_section_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/SectionsApi.md#insert_section_for_project) | **POST** /projects/{project_gid}/sections/insert | Move or Insert sections\n*SectionsApi* | [**update_section**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/SectionsApi.md#update_section) | **PUT** /sections/{section_gid} | Update a section\n*StatusUpdatesApi* | [**create_status_for_object**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/StatusUpdatesApi.md#create_status_for_object) | **POST** /status_updates | Create a status update\n*StatusUpdatesApi* | [**delete_status**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/StatusUpdatesApi.md#delete_status) | **DELETE** /status_updates/{status_update_gid} | Delete a status update\n*StatusUpdatesApi* | [**get_status**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/StatusUpdatesApi.md#get_status) | **GET** /status_updates/{status_update_gid} | Get a status update\n*StatusUpdatesApi* | [**get_statuses_for_object**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/StatusUpdatesApi.md#get_statuses_for_object) | **GET** /status_updates | Get status updates from an object\n*StoriesApi* | [**create_story_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/StoriesApi.md#create_story_for_task) | **POST** /tasks/{task_gid}/stories | Create a story on a task\n*StoriesApi* | [**delete_story**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/StoriesApi.md#delete_story) | **DELETE** /stories/{story_gid} | Delete a story\n*StoriesApi* | [**get_stories_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/StoriesApi.md#get_stories_for_task) | **GET** /tasks/{task_gid}/stories | Get stories from a task\n*StoriesApi* | [**get_story**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/StoriesApi.md#get_story) | **GET** /stories/{story_gid} | Get a story\n*StoriesApi* | [**update_story**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/StoriesApi.md#update_story) | **PUT** /stories/{story_gid} | Update a story\n*TagsApi* | [**create_tag**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TagsApi.md#create_tag) | **POST** /tags | Create a tag\n*TagsApi* | [**create_tag_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TagsApi.md#create_tag_for_workspace) | **POST** /workspaces/{workspace_gid}/tags | Create a tag in a workspace\n*TagsApi* | [**delete_tag**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TagsApi.md#delete_tag) | **DELETE** /tags/{tag_gid} | Delete a tag\n*TagsApi* | [**get_tag**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TagsApi.md#get_tag) | **GET** /tags/{tag_gid} | Get a tag\n*TagsApi* | [**get_tags**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TagsApi.md#get_tags) | **GET** /tags | Get multiple tags\n*TagsApi* | [**get_tags_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TagsApi.md#get_tags_for_task) | **GET** /tasks/{task_gid}/tags | Get a task's tags\n*TagsApi* | [**get_tags_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TagsApi.md#get_tags_for_workspace) | **GET** /workspaces/{workspace_gid}/tags | Get tags in a workspace\n*TagsApi* | [**update_tag**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TagsApi.md#update_tag) | **PUT** /tags/{tag_gid} | Update a tag\n*TaskTemplatesApi* | [**delete_task_template**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TaskTemplatesApi.md#delete_task_template) | **DELETE** /task_templates/{task_template_gid} | Delete a task template\n*TaskTemplatesApi* | [**get_task_template**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TaskTemplatesApi.md#get_task_template) | **GET** /task_templates/{task_template_gid} | Get a task template\n*TaskTemplatesApi* | [**get_task_templates**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TaskTemplatesApi.md#get_task_templates) | **GET** /task_templates | Get multiple task templates\n*TaskTemplatesApi* | [**instantiate_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TaskTemplatesApi.md#instantiate_task) | **POST** /task_templates/{task_template_gid}/instantiateTask | Instantiate a task from a task template\n*TasksApi* | [**add_dependencies_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#add_dependencies_for_task) | **POST** /tasks/{task_gid}/addDependencies | Set dependencies for a task\n*TasksApi* | [**add_dependents_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#add_dependents_for_task) | **POST** /tasks/{task_gid}/addDependents | Set dependents for a task\n*TasksApi* | [**add_followers_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#add_followers_for_task) | **POST** /tasks/{task_gid}/addFollowers | Add followers to a task\n*TasksApi* | [**add_project_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#add_project_for_task) | **POST** /tasks/{task_gid}/addProject | Add a project to a task\n*TasksApi* | [**add_tag_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#add_tag_for_task) | **POST** /tasks/{task_gid}/addTag | Add a tag to a task\n*TasksApi* | [**create_subtask_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#create_subtask_for_task) | **POST** /tasks/{task_gid}/subtasks | Create a subtask\n*TasksApi* | [**create_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#create_task) | **POST** /tasks | Create a task\n*TasksApi* | [**delete_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#delete_task) | **DELETE** /tasks/{task_gid} | Delete a task\n*TasksApi* | [**duplicate_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#duplicate_task) | **POST** /tasks/{task_gid}/duplicate | Duplicate a task\n*TasksApi* | [**get_dependencies_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_dependencies_for_task) | **GET** /tasks/{task_gid}/dependencies | Get dependencies from a task\n*TasksApi* | [**get_dependents_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_dependents_for_task) | **GET** /tasks/{task_gid}/dependents | Get dependents from a task\n*TasksApi* | [**get_subtasks_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_subtasks_for_task) | **GET** /tasks/{task_gid}/subtasks | Get subtasks from a task\n*TasksApi* | [**get_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_task) | **GET** /tasks/{task_gid} | Get a task\n*TasksApi* | [**get_task_for_custom_id**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_task_for_custom_id) | **GET** /workspaces/{workspace_gid}/tasks/custom_id/{custom_id} | Get a task for a given custom ID\n*TasksApi* | [**get_tasks**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_tasks) | **GET** /tasks | Get multiple tasks\n*TasksApi* | [**get_tasks_for_project**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_tasks_for_project) | **GET** /projects/{project_gid}/tasks | Get tasks from a project\n*TasksApi* | [**get_tasks_for_section**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_tasks_for_section) | **GET** /sections/{section_gid}/tasks | Get tasks from a section\n*TasksApi* | [**get_tasks_for_tag**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_tasks_for_tag) | **GET** /tags/{tag_gid}/tasks | Get tasks from a tag\n*TasksApi* | [**get_tasks_for_user_task_list**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_tasks_for_user_task_list) | **GET** /user_task_lists/{user_task_list_gid}/tasks | Get tasks from a user task list\n*TasksApi* | [**remove_dependencies_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#remove_dependencies_for_task) | **POST** /tasks/{task_gid}/removeDependencies | Unlink dependencies from a task\n*TasksApi* | [**remove_dependents_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#remove_dependents_for_task) | **POST** /tasks/{task_gid}/removeDependents | Unlink dependents from a task\n*TasksApi* | [**remove_follower_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#remove_follower_for_task) | **POST** /tasks/{task_gid}/removeFollowers | Remove followers from a task\n*TasksApi* | [**remove_project_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#remove_project_for_task) | **POST** /tasks/{task_gid}/removeProject | Remove a project from a task\n*TasksApi* | [**remove_tag_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#remove_tag_for_task) | **POST** /tasks/{task_gid}/removeTag | Remove a tag from a task\n*TasksApi* | [**search_tasks_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#search_tasks_for_workspace) | **GET** /workspaces/{workspace_gid}/tasks/search | Search tasks in a workspace\n*TasksApi* | [**set_parent_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#set_parent_for_task) | **POST** /tasks/{task_gid}/setParent | Set the parent of a task\n*TasksApi* | [**update_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#update_task) | **PUT** /tasks/{task_gid} | Update a task\n*TeamMembershipsApi* | [**get_team_membership**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamMembershipsApi.md#get_team_membership) | **GET** /team_memberships/{team_membership_gid} | Get a team membership\n*TeamMembershipsApi* | [**get_team_memberships**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamMembershipsApi.md#get_team_memberships) | **GET** /team_memberships | Get team memberships\n*TeamMembershipsApi* | [**get_team_memberships_for_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamMembershipsApi.md#get_team_memberships_for_team) | **GET** /teams/{team_gid}/team_memberships | Get memberships from a team\n*TeamMembershipsApi* | [**get_team_memberships_for_user**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamMembershipsApi.md#get_team_memberships_for_user) | **GET** /users/{user_gid}/team_memberships | Get memberships from a user\n*TeamsApi* | [**add_user_for_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamsApi.md#add_user_for_team) | **POST** /teams/{team_gid}/addUser | Add a user to a team\n*TeamsApi* | [**create_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamsApi.md#create_team) | **POST** /teams | Create a team\n*TeamsApi* | [**get_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamsApi.md#get_team) | **GET** /teams/{team_gid} | Get a team\n*TeamsApi* | [**get_teams_for_user**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamsApi.md#get_teams_for_user) | **GET** /users/{user_gid}/teams | Get teams for a user\n*TeamsApi* | [**get_teams_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamsApi.md#get_teams_for_workspace) | **GET** /workspaces/{workspace_gid}/teams | Get teams in a workspace\n*TeamsApi* | [**remove_user_for_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamsApi.md#remove_user_for_team) | **POST** /teams/{team_gid}/removeUser | Remove a user from a team\n*TeamsApi* | [**update_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TeamsApi.md#update_team) | **PUT** /teams/{team_gid} | Update a team\n*TimePeriodsApi* | [**get_time_period**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TimePeriodsApi.md#get_time_period) | **GET** /time_periods/{time_period_gid} | Get a time period\n*TimePeriodsApi* | [**get_time_periods**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TimePeriodsApi.md#get_time_periods) | **GET** /time_periods | Get time periods\n*TimeTrackingEntriesApi* | [**create_time_tracking_entry**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TimeTrackingEntriesApi.md#create_time_tracking_entry) | **POST** /tasks/{task_gid}/time_tracking_entries | Create a time tracking entry\n*TimeTrackingEntriesApi* | [**delete_time_tracking_entry**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TimeTrackingEntriesApi.md#delete_time_tracking_entry) | **DELETE** /time_tracking_entries/{time_tracking_entry_gid} | Delete a time tracking entry\n*TimeTrackingEntriesApi* | [**get_time_tracking_entries_for_task**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TimeTrackingEntriesApi.md#get_time_tracking_entries_for_task) | **GET** /tasks/{task_gid}/time_tracking_entries | Get time tracking entries for a task\n*TimeTrackingEntriesApi* | [**get_time_tracking_entry**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TimeTrackingEntriesApi.md#get_time_tracking_entry) | **GET** /time_tracking_entries/{time_tracking_entry_gid} | Get a time tracking entry\n*TimeTrackingEntriesApi* | [**update_time_tracking_entry**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TimeTrackingEntriesApi.md#update_time_tracking_entry) | **PUT** /time_tracking_entries/{time_tracking_entry_gid} | Update a time tracking entry\n*TypeaheadApi* | [**typeahead_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TypeaheadApi.md#typeahead_for_workspace) | **GET** /workspaces/{workspace_gid}/typeahead | Get objects via typeahead\n*UserTaskListsApi* | [**get_user_task_list**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/UserTaskListsApi.md#get_user_task_list) | **GET** /user_task_lists/{user_task_list_gid} | Get a user task list\n*UserTaskListsApi* | [**get_user_task_list_for_user**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/UserTaskListsApi.md#get_user_task_list_for_user) | **GET** /users/{user_gid}/user_task_list | Get a user's task list\n*UsersApi* | [**get_favorites_for_user**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/UsersApi.md#get_favorites_for_user) | **GET** /users/{user_gid}/favorites | Get a user's favorites\n*UsersApi* | [**get_user**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/UsersApi.md#get_user) | **GET** /users/{user_gid} | Get a user\n*UsersApi* | [**get_users**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/UsersApi.md#get_users) | **GET** /users | Get multiple users\n*UsersApi* | [**get_users_for_team**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/UsersApi.md#get_users_for_team) | **GET** /teams/{team_gid}/users | Get users in a team\n*UsersApi* | [**get_users_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/UsersApi.md#get_users_for_workspace) | **GET** /workspaces/{workspace_gid}/users | Get users in a workspace or organization\n*WebhooksApi* | [**create_webhook**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WebhooksApi.md#create_webhook) | **POST** /webhooks | Establish a webhook\n*WebhooksApi* | [**delete_webhook**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WebhooksApi.md#delete_webhook) | **DELETE** /webhooks/{webhook_gid} | Delete a webhook\n*WebhooksApi* | [**get_webhook**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WebhooksApi.md#get_webhook) | **GET** /webhooks/{webhook_gid} | Get a webhook\n*WebhooksApi* | [**get_webhooks**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WebhooksApi.md#get_webhooks) | **GET** /webhooks | Get multiple webhooks\n*WebhooksApi* | [**update_webhook**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WebhooksApi.md#update_webhook) | **PUT** /webhooks/{webhook_gid} | Update a webhook\n*WorkspaceMembershipsApi* | [**get_workspace_membership**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WorkspaceMembershipsApi.md#get_workspace_membership) | **GET** /workspace_memberships/{workspace_membership_gid} | Get a workspace membership\n*WorkspaceMembershipsApi* | [**get_workspace_memberships_for_user**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WorkspaceMembershipsApi.md#get_workspace_memberships_for_user) | **GET** /users/{user_gid}/workspace_memberships | Get workspace memberships for a user\n*WorkspaceMembershipsApi* | [**get_workspace_memberships_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WorkspaceMembershipsApi.md#get_workspace_memberships_for_workspace) | **GET** /workspaces/{workspace_gid}/workspace_memberships | Get the workspace memberships for a workspace\n*WorkspacesApi* | [**add_user_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WorkspacesApi.md#add_user_for_workspace) | **POST** /workspaces/{workspace_gid}/addUser | Add a user to a workspace or organization\n*WorkspacesApi* | [**get_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WorkspacesApi.md#get_workspace) | **GET** /workspaces/{workspace_gid} | Get a workspace\n*WorkspacesApi* | [**get_workspace_events**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WorkspacesApi.md#get_workspace_events) | **GET** /workspaces/{workspace_gid}/events | Get workspace events\n*WorkspacesApi* | [**get_workspaces**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WorkspacesApi.md#get_workspaces) | **GET** /workspaces | Get multiple workspaces\n*WorkspacesApi* | [**remove_user_for_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WorkspacesApi.md#remove_user_for_workspace) | **POST** /workspaces/{workspace_gid}/removeUser | Remove a user from a workspace or organization\n*WorkspacesApi* | [**update_workspace**](https://github.com/Asana/python-asana/blob/v5.1.0/docs/WorkspacesApi.md#update_workspace) | **PUT** /workspaces/{workspace_gid} | Update a workspace\n\n## Accessing response data\n\n### Example: Accessing task data\n```python\n.\n.\n.\ntry:\n task = tasks_api_instance.get_task(task_gid, opts)\n task_name = task['name']\n task_notes = task['notes']\nexcept ApiException as e:\n .\n .\n .\n```\n\n## Accessing response status code and headers\n\nIn the scenario you want to access the response headers or the status code along with the response data you can\nprovide the `_return_http_data_only` parameter argument in the request method and set the value to `False`\n\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\n# create an instance of the API class\nusers_api_instance = asana.UsersApi(api_client)\nuser_gid = 'me' # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nopts = {}\n\ntry:\n # Get a user - Add asana-enable in the request\n (api_response, status, headers) = users_api_instance.get_user(user_gid, opts, _return_http_data_only=False) # returns a tuple: (response, status, headers)\n pprint(api_response)\n pprint(status)\n pprint(headers)\nexcept ApiException as e:\n print(\"Exception when calling UsersApi->get_user: %s\\n\" % e)\n```\n\n## Adding deprecation flag: \"asana-enable\" or \"asana-disable\" header\n\n### On the client\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\n# Add asana-enable header for the client\napi_client.default_headers['asana-enable'] = 'string_ids'\n```\n\nOR\n\n### On the request\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\n# create an instance of the API class\nusers_api_instance = asana.UsersApi(api_client)\nuser_gid = 'me' # str | A string identifying a user. This can either be the string \\\"me\\\", an email, or the gid of a user.\nopts = {}\n\ntry:\n # Get a user - Add asana-enable in the request\n api_response = users_api_instance.get_user(user_gid, opts, header_params={'asana-enable': 'string_ids'})\n pprint(api_response)\nexcept ApiException as e:\n print(\"Exception when calling UsersApi->get_user: %s\\n\" % e)\n```\n\n## Async requests with multithreading\n\nThis client library uses multithreading to make async requests. To make async requests you can pass in `async_req=True` in the method call.\n\nNOTE:\n- This feature disables our auto-pagination feature\n- You will want to add logic to handle the Asana API rate limits\n\nThe code belows is an example of how to make 15 async create task calls. It does not handle the Asana API rate limits.\nYou will have to implement your own solution for API rate limits based on your tier.\n\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\ntasks_api_instance = asana.TasksApi(api_client)\nthreads = []\nfor i in range(1, 15+1):\n body = {\n \"data\": {\n \"name\": f\"Task: {i}\",\n \"projects\": [\"\"]\n }\n }\n opts = {}\n threads.append(tasks_api_instance.create_task(body, opts, async_req=True))\n\nfor thread in threads:\n try:\n pprint(thread.get())\n except ApiException as e:\n print(\"Exception when calling TasksApi->create_task: %s\\n\" % e)\n```\n\n## Pagination\n\nThe pagination feature is enabled by default. This means two things:\n\n1: Endpoints that return a single response (EX: [get_task](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_task) ([Get a task](https://developers.asana.com/reference/gettask)), [get_project](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_project) ([Get a project](https://developers.asana.com/reference/getproject)), etc...)\nwill return a response with the `\"data\"` key abstracted from the response.\n\nInstead of returning:\n```python\n{\n \"data\": {\n \"gid\": \"123\",\n \"actual_time_minutes\": null,\n \"assignee\": null,\n ...\n \"workspace\": {\n \"gid\": \"1234567\",\n \"name\": \"user@example.com\",\n \"resource_type\": \"workspace\"\n }\n }\n}\n```\n\nIt returns:\n```python\n{\n \"gid\": \"123\",\n \"actual_time_minutes\": null,\n \"assignee\": null,\n ...\n \"workspace\": {\n \"gid\": \"1234567\",\n \"name\": \"user@example.com\",\n \"resource_type\": \"workspace\"\n }\n}\n```\n\n2: Endpoints that return an array of resources (EX: [get_tasks](https://github.com/Asana/python-asana/blob/v5.1.0/docs/TasksApi.md#get_tasks) ([Get multiple tasks](https://developers.asana.com/reference/gettasks)), [get_projects](https://github.com/Asana/python-asana/blob/v5.1.0/docs/ProjectsApi.md#get_projects) ([Get multiple projects](https://developers.asana.com/reference/getprojects)), etc...)\nwill return a generator object ([PageIterator.items](https://github.com/Asana/python-asana/blob/v5.1.0/asana/pagination/page_iterator.py)) that you can use to iterate through each result.\n\nExample usage 1:\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\ntasks_api_instance = asana.TasksApi(api_client)\nopts = {\"project\": \"\"}\n\ntry:\n tasks = tasks_api_instance.get_tasks(opts)\n for task in tasks:\n pprint(task)\n\nexcept Exception as e:\n print(\"Exception when calling TasksApi->get_tasks: %s\\n\" % e)\n```\n\nExample response:\n```python\n{'gid': '123',\n 'name': 'Task 1',\n 'resource_subtype': 'default_task',\n 'resource_type': 'task'},\n .\n .\n .\n```\n\nExample usage 2:\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\ntasks_api_instance = asana.TasksApi(api_client)\nopts = {\"project\": \"\"}\n\ntry:\n tasks = tasks_api_instance.get_tasks(opts)\n pprint(list(tasks))\n\nexcept Exception as e:\n print(\"Exception when calling TasksApi->get_tasks: %s\\n\" % e)\n```\n\nExample response:\n```python\n[{'gid': '123',\n 'name': 'Task 1',\n 'resource_subtype': 'default_task',\n 'resource_type': 'task'},\n .\n .\n .]\n```\n\n### Ending pagination early\n\nIn the scenario where you want to end the pagination early, you can specify an `item_limit` in the method call. This will stop the iterator from going past that limit.\n\n**Example Scenario:** You have 1000 tasks in a project and are only interested in the first 2 tasks. Instead of letting the pagination code continue to run to get all those 1000 tasks you can specify that you only want the first X results with `item_limit`.\n\n**Without `item_limit` - The for loop will continue to run until it runs out of tasks:**\n\n```python\n ...\n tasks = tasks_api_instance.get_tasks(opts)\n for task in tasks:\n pprint(task)\n ...\n```\n\n**Sample response:**\n\n```python\n{'gid': '123',\n 'name': 'Task 1',\n 'resource_subtype': 'default_task',\n 'resource_type': 'task'},\n .\n .\n .\n <1000th_TASK>\n```\n\n**With `item_limit` - the for loop will stop at the `item_limit` you specified:**\n```python\n ...\n tasks = tasks_api_instance.get_tasks(opts, item_limit=2)\n for task in tasks:\n pprint(task)\n ...\n```\n\n**Sample response:**\n\n```python\n{'gid': '123',\n 'name': 'Task 1',\n 'resource_subtype': 'default_task',\n 'resource_type': 'task'},\n{'gid': '456',\n 'name': 'Task 2',\n 'resource_subtype': 'default_task',\n 'resource_type': 'task'}\n```\n\nAlternatively, if you are iterating over the generator object in a for loop, you can also just break out of the loop.\n\n**EX:**\n```python\n...\nopts = {'project': \"\"}\n\ntry:\n count = 0\n tasks = tasks_api_instance.get_tasks(opts)\n for task in tasks:\n if count == 2:\n break\n pprint(task)\n count += 1\n ...\n```\n\n**Sample response:**\n\n```python\n{'gid': '123',\n 'name': 'Task 1',\n 'resource_subtype': 'default_task',\n 'resource_type': 'task'},\n {'gid': '456',\n 'name': 'Task 2',\n 'resource_subtype': 'default_task',\n 'resource_type': 'task'}\n```\n\n### Disabling default pagination behaviour\n\nIf you do not want to use the default pagination behaviour there are two ways to disbale it.\n\n1: Per request - Disable pagination behavior for a single request - pass in `full_payload=True` in the method request\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\ntasks_api_instance = asana.TasksApi(api_client)\nopts = {\"project\": \"\", \"limit\": 2}\n\ntry:\n tasks = tasks_api_instance.get_tasks(opts, full_payload=True)\n pprint(tasks)\nexcept Exception as e:\n print(\"Exception when calling TasksApi->get_tasks: %s\\n\" % e)\n```\n\nSample response:\n```python\n{'data': [{'gid': '123',\n 'name': 'Task 1',\n 'resource_subtype': 'default_task',\n 'resource_type': 'task'},\n {'gid': '456',\n 'name': 'Task 2',\n 'resource_subtype': 'default_task',\n 'resource_type': 'task'}],\n 'next_page': {'offset': 'eyJ0...',\n 'path': '/tasks?project=789&limit=2&offset=eyJ0...',\n 'uri': 'https://app.asana.com/api/1.0/tasks?project=789&limit=2&offset=eyJ0...'}}\n```\n\n2: Globally - Disable pagination behavior for all requests - Set `return_page_iterator` to False\n```python\n...\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\nconfiguration.return_page_iterator = False\napi_client = asana.ApiClient(configuration)\n...\n```\n\n## Retries\n\n### Default configuration\n\nBy default, we retry failed requests (i.e., requests that receive any of the following response statuses: `429`, `500`, `502`, `503`, or `504`)\nup to 5 times, using a backoff factor of 2, resulting in wait times of 1s, 2s, 4s, 8s, and 16s between attempts.\nFor `429 (Too Many Requests)` responses, the `respect_retry_after_header` option is set to `True` by default\n(See [urllib3](https://urllib3.readthedocs.io/en/stable/reference/urllib3.util.html)), ensuring that retries adhere to the `Retry-After` header\nfrom the [Asana API](https://developers.asana.com/docs/rate-limits).\n\n\nNOTE: the retry strategy applies to `DELETE`, `GET`, `HEAD`, `OPTIONS`, `PUT`, `TRACE` requests (See `allowed_methods` in [urllib3](https://urllib3.readthedocs.io/en/stable/reference/urllib3.util.html))\n\n```\nself.retry_strategy = Retry(\n total=5, # Number of retries\n backoff_factor=2, # Exponential backoff factor (1s, 2s, 4s, etc.)\n status_forcelist=[429, 500, 502, 503, 504], # Retry only on these status codes\n)\n```\n\n### Customize retry configuration/strategy\n\nTo customize your retry strategy, you can override the default `retry_strategy` in your configuration.\nFor details on configurable options for Retry, refer to the documentation: [urllib3](https://urllib3.readthedocs.io/en/stable/reference/urllib3.util.html).\n\n#### Example - override default `retry_strategy`\n```\nimport asana\nfrom urllib3.util.retry import Retry\n\nconfiguration = asana.Configuration()\nconfiguration.retry_strategy = Retry(\n total=10, # Maximum number of retries\n backoff_factor=4, # Exponential backoff factor (1s, 2s, 4s, etc.)\n)\n...\n```\n\n## Documentation for Using the `call_api` method\n\nUse this to make HTTP calls when the endpoint does not exist in the current library version or has bugs\n\n### Example: GET, POST, PUT, DELETE on tasks\n\n#### GET - get a task\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\ntry:\n # GET - get a task\n api_response = api_client.call_api(\n \"/tasks/{task_gid}\",\n \"GET\",\n path_params={\"task_gid\": \"\"},\n query_params={},\n header_params={\"Accept\": \"application/json; charset=utf-8\"},\n body=None,\n post_params=[],\n files={},\n response_type=object, # You can specify one of the following types: float, bool, bytes, str, object\n auth_settings=[\"token\"],\n async_req=None,\n _return_http_data_only=True,\n _preload_content=True,\n _request_timeout=None,\n collection_formats={},\n )\n pprint(api_response)\nexcept ApiException as e:\n print(\"Exception: %s\\n\" % e)\n```\n\n#### GET - get multiple tasks -> with opt_fields\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\ntry:\n # GET - get multiple tasks\n api_response = api_client.call_api(\n \"/tasks\",\n \"GET\",\n path_params={},\n query_params={\n \"project\": \"\",\n \"opt_fields\": \"name,notes,projects\",\n },\n header_params={\"Accept\": \"application/json; charset=utf-8\"},\n body=None,\n post_params=[],\n files={},\n response_type=object, # You can specify one of the following types: float, bool, bytes, str, object\n auth_settings=[\"token\"],\n async_req=None,\n _return_http_data_only=True,\n _preload_content=True,\n _request_timeout=None,\n collection_formats={},\n )\n pprint(api_response)\nexcept ApiException as e:\n print(\"Exception: %s\\n\" % e)\n```\n\n#### POST - create a task\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\ntry:\n # POST - create a task\n api_response = api_client.call_api(\n \"/tasks\",\n \"POST\",\n path_params={},\n query_params={},\n header_params={\n \"Accept\": \"application/json; charset=utf-8\",\n \"Content-Type\": \"application/json; charset=utf-8\",\n },\n body={\n \"data\": {\n \"name\": \"New Task\",\n \"projects\": [\"\"],\n }\n },\n post_params=[],\n files={},\n response_type=object, # You can specify one of the following types: float, bool, bytes, str, object\n auth_settings=[\"token\"],\n async_req=None,\n _return_http_data_only=True,\n _preload_content=True,\n _request_timeout=None,\n collection_formats={},\n )\n pprint(api_response)\nexcept ApiException as e:\n print(\"Exception: %s\\n\" % e)\n```\n\n#### PUT - update a task\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\ntry:\n # PUT - update a task\n api_response = api_client.call_api(\n \"/tasks/{task_gid}\",\n \"PUT\",\n path_params={\"task_gid\": \"\"},\n query_params={},\n header_params={\n \"Accept\": \"application/json; charset=utf-8\",\n \"Content-Type\": \"application/json; charset=utf-8\",\n },\n body={\n \"data\": {\n \"name\": \"Updated Task\",\n }\n },\n post_params=[],\n files={},\n response_type=object, # You can specify one of the following types: float, bool, bytes, str, object\n auth_settings=[\"token\"],\n async_req=None,\n _return_http_data_only=True,\n _preload_content=True,\n _request_timeout=None,\n collection_formats={},\n )\n pprint(api_response)\nexcept ApiException as e:\n print(\"Exception: %s\\n\" % e)\n```\n\n#### DELETE - delete a task\n```python\nimport asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = ''\napi_client = asana.ApiClient(configuration)\n\ntry:\n # DELETE - delete a task\n api_response = api_client.call_api(\n \"/tasks/{task_gid}\",\n \"DELETE\",\n path_params={\"task_gid\": \"\"},\n query_params={},\n header_params={\"Accept\": \"application/json; charset=utf-8\"},\n body=None,\n post_params=[],\n files={},\n response_type=object, # You can specify one of the following types: float, bool, bytes, str, object\n auth_settings=[\"token\"],\n async_req=None,\n _return_http_data_only=True,\n _preload_content=True,\n _request_timeout=None,\n collection_formats={},\n )\n pprint(api_response)\nexcept ApiException as e:\n print(\"Exception: %s\\n\" % e)\n```\n\n[release-image]: https://img.shields.io/github/release/asana/python-asana.svg\n\n[pypi-image]: https://img.shields.io/pypi/v/asana.svg?style=flat-square\n[pypi-url]: https://pypi.python.org/pypi/asana/\n","description_content_type":"text/markdown","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":["Author","Description","Description-Content-Type","Home-Page","Keywords","License","Requires-Dist","Summary"],"home_page":"http://github.com/asana/python-asana","keywords":"asana, Asana","license":"MIT","license_expression":null,"license_files":null,"maintainer":null,"maintainer_email":null,"name":"asana","package_url":"https://pypi.org/project/asana/","platform":null,"project_url":"https://pypi.org/project/asana/","project_urls":{"Homepage":"http://github.com/asana/python-asana"},"provides_extra":null,"release_url":"https://pypi.org/project/asana/5.1.0/","requires_dist":["certifi>=2017.4.17","python-dateutil>=2.1","six>=1.10","urllib3>=1.23"],"requires_python":null,"summary":"Asana","version":"5.1.0","yanked":false,"yanked_reason":null}

Dependencies of asana (4).
Dependency	Optional
certifi	false
python-dateutil	false
six	false
urllib3	false

Package search

asana

project_urls

Dependencies

All package metadata

Releases