API Reference

The full Asana REST API grouped by resource. Each section lists every operation plus a resource overview page where one exists.

Overview (1)

• Overview

Tasks (26)

• Duplicate a task
• Instantiate a task from a task template
• Tasks
• Add a tag to a task
• Create a subtask
• Create a task
• Delete a task
• Get a task
• Get a task for a given custom ID
• Get a task's tags
• Get a user task list
• Get a user's task list
• Get dependencies from a task
• Get dependents from a task
• Get multiple tasks
• Get subtasks from a task
• Get tasks from a tag
• Get tasks from a user task list
• Remove a tag from a task
• Remove followers from a task
• Set dependencies for a task
• Set dependents for a task
• Set the parent of a task
• Unlink dependencies from a task
• Unlink dependents from a task
• Update a task

Projects (21)

• Create a project template from a project
• Duplicate a project
• Instantiate a project from a project template
• Move or Insert sections
• Projects
• Add a project to a task
• Add users to a project
• Create a project
• Create a project in a team
• Create a section in a project
• Delete a project
• Get a project
• Get a team's projects
• Get multiple projects
• Get projects a task is in
• Get sections in a project
• Get task count of a project
• Get tasks from a project
• Remove a project from a task
• Remove users from a project
• Update a project

Sections (6)

• Sections
• Add task to section
• Delete a section
• Get a section
• Get tasks from a section
• Update a section

Workspaces (17)

• Workspaces
• Add a user to a workspace or organization
• Create a project in a workspace
• Create a tag in a workspace
• Get a user in a workspace or organization
• Get a workspace
• Get all projects in a workspace
• Get multiple workspaces
• Get tags in a workspace
• Get teams in a workspace
• Get users in a workspace or organization
• Get workspace events
• Remove a user from a workspace or organization
• Search projects in a workspace
• Search tasks in a workspace
• Update a user in a workspace or organization
• Update a workspace

Users (5)

• Users
• Get a user
• Get a user's favorites
• Get multiple users
• Update a user

Teams (8)

• Teams
• Add a user to a team
• Create a team
• Get a team
• Get teams for a user
• Get users in a team
• Remove a user from a team
• Update a team

Portfolios (17)

• Duplicate a portfolio
• Portfolios
• Project portfolio settings
• Add a portfolio item
• Add users to a portfolio
• Create a portfolio
• Delete a portfolio
• Get a portfolio
• Get a project portfolio setting
• Get multiple portfolios
• Get portfolio items
• Get project portfolio settings for a portfolio
• Get project portfolio settings for a project
• Remove a portfolio item
• Remove users from a portfolio
• Update a portfolio
• Update a project portfolio setting

Goals (20)

• Goal relationships
• Goals
• Add a collaborator to a goal
• Add a supporting goal relationship
• Add followers to a project
• Add followers to a task
• Create a goal
• Create a goal metric
• Delete a goal
• Get a goal
• Get a goal relationship
• Get goal relationships
• Get goals
• Get parent goals from a goal
• Remove a collaborator from a goal
• Remove followers from a project
• Removes a supporting goal relationship
• Update a goal
• Update a goal metric
• Update a goal relationship

Status Updates (5)

• Status updates
• Create a status update
• Delete a status update
• Get a status update
• Get status updates from an object

Project Statuses (5)

• Project statuses
• Create a project status
• Delete a project status
• Get a project status
• Get statuses from a project

Project Briefs (5)

• Project briefs
• Create a project brief
• Delete a project brief
• Get a project brief
• Update a project brief

Project Templates (5)

• Project templates
• Delete a project template
• Get a project template
• Get a team's project templates
• Get multiple project templates

Project Memberships (3)

• Project memberships
• Get a project membership
• Get memberships from a project

Task Templates (4)

• Task templates
• Delete a task template
• Get a task template
• Get multiple task templates

Stories (8)

• Stories
• Create a story on a goal
• Create a story on a task
• Delete a story
• Get a story
• Get stories from a goal
• Get stories from a task
• Update a story

Attachments (5)

• Attachments
• Delete an attachment
• Get an attachment
• Get attachments from an object
• Upload an attachment

Tags (6)

• Tags
• Create a tag
• Delete a tag
• Get a tag
• Get multiple tags
• Update a tag

Custom Fields (20)

• Custom field settings
• Custom fields
• Reorder a custom field's enum
• Add a custom field to a goal
• Add a custom field to a portfolio
• Add a custom field to a project
• Create a custom field
• Create an enum option
• Delete a custom field
• Get a custom field
• Get a goal's custom fields
• Get a portfolio's custom fields
• Get a project's custom fields
• Get a team's custom fields
• Get a workspace's custom fields
• Remove a custom field from a goal
• Remove a custom field from a portfolio
• Remove a custom field from a project
• Update a custom field
• Update an enum option

Custom Types (4)

• Attach resource
• Custom types
• Get a custom type
• Get all custom types associated with an object

Memberships (10)

• Memberships
• Portfolio memberships
• Create a membership
• Delete a membership
• Get a membership
• Get a portfolio membership
• Get memberships from a portfolio
• Get multiple memberships
• Get multiple portfolio memberships
• Update a membership

Team Memberships (5)

• Team memberships
• Get a team membership
• Get memberships from a team
• Get memberships from a user
• Get team memberships

Workspace Memberships (4)

• Workspace memberships
• Get a workspace membership
• Get the workspace memberships for a workspace
• Get workspace memberships for a user

User Task Lists (1)

• User task lists

Allocations (6)

• Allocations
• Create an allocation
• Delete an allocation
• Get an allocation
• Get multiple allocations
• Update an allocation

Budgets (6)

• Budgets
• Create a budget
• Delete a budget
• Get a budget
• Get all budgets
• Update a budget

Time Periods (3)

• Time periods
• Get a time period
• Get time periods

Time Tracking Entries (7)

• Time tracking entries
• Create a time tracking entry
• Delete a time tracking entry
• Get a time tracking entry
• Get multiple time tracking entries
• Get time tracking entries for a task
• Update a time tracking entry

Time Tracking Categories (7)

• Time tracking categories
• Create a time tracking category
• Delete a time tracking category
• Get a time tracking category
• Get time tracking categories for a workspace
• Get time tracking entries for a time tracking category
• Update a time tracking category

Timesheet Approval (5)

• Timesheet approval statuses
• Create a timesheet approval status
• Get a timesheet approval status
• Get multiple timesheet approval statuses
• Update a timesheet approval status

Rates (6)

• Rates
• Create a rate
• Delete a rate
• Get a rate
• Get multiple rates
• Update a rate

Roles (6)

• Roles
• Create a role
• Delete a role
• Get a role
• Get multiple roles
• Update a role

Rules (2)

• Rules
• Trigger a rule

Reactions (2)

• Reactions
• Get reactions with an emoji base on an object.

OOO Entries (6)

• Ooo entries
• Create an OOO entry
• Delete an OOO entry
• Get an OOO entry
• Get OOO entries for a user
• Update an OOO entry

Audit Log API (2)

• Audit log API
• Get audit log events

Access Requests (5)

• Access requests
• Approve an access request
• Create an access request
• Get access requests
• Reject an access request

Organization Exports (3)

• Organization exports
• Create an organization export request
• Get details on an org export request

Exports (3)

• Exports
• Initiate a graph export
• Initiate a resource export

Events (2)

• Events
• Get events on a resource

Jobs (2)

• Jobs
• Get a job by id

Webhooks API (6)

• Webhooks
• Delete a webhook
• Establish a webhook
• Get a webhook
• Get multiple webhooks
• Update a webhook

Batch API (2)

• Batch API
• Submit parallel requests

Typeahead (4)

• Get objects via typeahead
• Typeahead
• Get lookup typeahead results
• Get modal form typeahead results

App Components Reference (1)

• Lookups

App Components: Forms (4)

• Modal forms
• On change callback
• On submit callback
• Get form metadata

App Components: Rules (6)

• On action change callback
• On action submit callback
• Rule actions
• Get action metadata
• Get rule action typeahead results
• Run action

App Components: Widgets (2)

• Widgets
• Get widget metadata