# Asana ## API Docs - Attachments [Delete an attachment](https://c32jre4vsi.apidog.io/api-3547229.md): Deletes a specific, existing attachment. - Attachments [Get an attachment](https://c32jre4vsi.apidog.io/api-3547232.md): Get the full record for a single attachment. - Attachments [Get attachments for a task](https://c32jre4vsi.apidog.io/api-3547219.md): Returns the compact records for all attachments on the task. - Attachments [Upload an attachment](https://c32jre4vsi.apidog.io/api-3547213.md): Upload an attachment. - Batch API [Submit parallel requests](https://c32jre4vsi.apidog.io/api-3547227.md): Make multiple requests in parallel to Asana's API. - Custom Fields [Create a custom field](https://c32jre4vsi.apidog.io/api-3547222.md): Creates a new custom field in a workspace. Every custom field is required - Custom Fields [Delete a custom field](https://c32jre4vsi.apidog.io/api-3547214.md): A specific, existing custom field can be deleted by making a DELETE request on the URL for that custom field. - Custom Fields [Get a custom field](https://c32jre4vsi.apidog.io/api-3547218.md): Get the complete definition of a custom field’s metadata. - Custom Fields [Update a custom field](https://c32jre4vsi.apidog.io/api-3547223.md): A specific, existing custom field can be updated by making a PUT request on the URL for that custom field. Only the fields provided in the `data` block will be updated; any unspecified fields will remain unchanged - Custom Fields [Create an enum option](https://c32jre4vsi.apidog.io/api-3547221.md): Creates an enum option and adds it to this custom field’s list of enum options. A custom field can have at most 50 enum options (including disabled options). By default new enum options are inserted at the end of a custom field’s list. - Custom Fields [Reorder a custom field's enum](https://c32jre4vsi.apidog.io/api-3547224.md): Moves a particular enum option to be either before or after another specified enum option in the custom field. - Custom Fields [Update an enum option](https://c32jre4vsi.apidog.io/api-3547225.md): Updates an existing enum option. Enum custom fields require at least one enabled enum option. - Custom Fields [Get a workspace's custom fields](https://c32jre4vsi.apidog.io/api-3547220.md): Returns a list of the compact representation of all of the custom fields in a workspace. - Events [Get events on a resource](https://c32jre4vsi.apidog.io/api-3547215.md): Returns the full record for all events that have occurred since the sync - Goals [Get goals](https://c32jre4vsi.apidog.io/api-3547231.md): Returns compact goal records. - Goals [Create a goal](https://c32jre4vsi.apidog.io/api-3547230.md): Creates a new goal in a workspace or team. - Goals [Delete a goal](https://c32jre4vsi.apidog.io/api-3547217.md): A specific, existing goal can be deleted by making a DELETE request on the URL for that goal. - Goals [Get a goal](https://c32jre4vsi.apidog.io/api-3547216.md): Returns the complete goal record for a single goal. - Goals [Update a goal](https://c32jre4vsi.apidog.io/api-3547226.md): An existing goal can be updated by making a PUT request on the URL for - Goals [Add a collaborator to a goal](https://c32jre4vsi.apidog.io/api-3547228.md): Adds followers to a goal. Returns the goal the followers were added to. - Goals [Add a subgoal to a parent goal](https://c32jre4vsi.apidog.io/api-3547233.md): Adds a subgoal to a parent goal. *A goal can have at most 100 subgoals, and a subgoal can have at most 4 parent goals. - Goals [Add a project/portfolio as supporting work for a goal.](https://c32jre4vsi.apidog.io/api-3547234.md): Adds a project or portfolio as supporting work for a goal. *A goal can have at most 10 supporting projects/portfolios, and a project/portfolio can support at most 10 goals*. - Goals [Get parent goals from a goal](https://c32jre4vsi.apidog.io/api-3547235.md): Returns a compact representation of all of the parent goals of a goal. - Goals [Remove a collaborator from a goal](https://c32jre4vsi.apidog.io/api-3547236.md): Removes followers from a goal. Returns the goal the followers were removed from. - Goals [Remove a subgoal from a goal](https://c32jre4vsi.apidog.io/api-3547237.md): Removes a goal as a subgoal of a specified parent goal. - Goals [Remove a project/portfolio as supporting work for a goal.](https://c32jre4vsi.apidog.io/api-3547238.md): Removes a project or portfolio as supporting work for a goal. - Goals [Create a goal metric](https://c32jre4vsi.apidog.io/api-3547245.md): Creates and adds a goal metric to a specified goal. Note that this replaces an existing goal metric if one already exists. - Goals [Update a goal metric](https://c32jre4vsi.apidog.io/api-3547247.md): Updates a goal's existing metric's `current_number_value` if one exists, - Goals [Get subgoals from a goal](https://c32jre4vsi.apidog.io/api-3547241.md): Returns a compact representation of all of the subgoals of a goal. - Goals [Get supporting work from a goal](https://c32jre4vsi.apidog.io/api-3547244.md): Returns any portfolios or projects associated with specified goal. - Jobs [Get a job by id](https://c32jre4vsi.apidog.io/api-3547240.md): Returns the full record for a job. - Organization Exports [Create an organization export request](https://c32jre4vsi.apidog.io/api-3547243.md): This method creates a request to export an Organization. Asana will complete the export at some point after you create the request. - Organization Exports [Get details on an org export request](https://c32jre4vsi.apidog.io/api-3547239.md): Returns details of a previously-requested Organization export. - Teams [Get teams in an organization](https://c32jre4vsi.apidog.io/api-3547242.md): Returns the compact records for all teams in the organization visible to the authorized user. - Teams [Create a team](https://c32jre4vsi.apidog.io/api-3547246.md): Creates a team within the current workspace. - Teams [Get a team](https://c32jre4vsi.apidog.io/api-3547248.md): Returns the full record for a single team. - Teams [Add a user to a team](https://c32jre4vsi.apidog.io/api-3547250.md): The user making this call must be a member of the team in order to add others. The user being added must exist in the same organization as the team. - Teams [Remove a user from a team](https://c32jre4vsi.apidog.io/api-3547251.md): The user making this call must be a member of the team in order to remove themselves or others. - Teams [Get teams for a user](https://c32jre4vsi.apidog.io/api-3547249.md): Returns the compact records for all teams to which the given user is assigned. - Portfolio Memberships [Get multiple portfolio memberships](https://c32jre4vsi.apidog.io/api-3547252.md): Returns a list of portfolio memberships in compact representation. You must specify `portfolio`, `portfolio` and `user`, or `workspace` and `user`. - Portfolio Memberships [Get a portfolio membership](https://c32jre4vsi.apidog.io/api-3547253.md): Returns the complete portfolio record for a single portfolio membership. - Portfolio Memberships [Get memberships from a portfolio](https://c32jre4vsi.apidog.io/api-3547254.md): Returns the compact portfolio membership records for the portfolio. - Portfolios [Get multiple portfolios](https://c32jre4vsi.apidog.io/api-3547257.md): Returns a list of the portfolios in compact representation that are owned by the current API user. - Portfolios [Create a portfolio](https://c32jre4vsi.apidog.io/api-3547258.md): Creates a new portfolio in the given workspace with the supplied name. - Portfolios [Delete a portfolio](https://c32jre4vsi.apidog.io/api-3547256.md): An existing portfolio can be deleted by making a DELETE request on - Portfolios [Get a portfolio](https://c32jre4vsi.apidog.io/api-3547255.md): Returns the complete portfolio record for a single portfolio. - Portfolios [Update a portfolio](https://c32jre4vsi.apidog.io/api-3547259.md): An existing portfolio can be updated by making a PUT request on the URL for - Portfolios [Add a custom field to a portfolio](https://c32jre4vsi.apidog.io/api-3547260.md): Custom fields are associated with portfolios by way of custom field settings. This method creates a setting for the portfolio. - Portfolios [Add a portfolio item](https://c32jre4vsi.apidog.io/api-3547261.md): Add an item to a portfolio. - Portfolios [Add users to a portfolio](https://c32jre4vsi.apidog.io/api-3547262.md): Adds the specified list of users as members of the portfolio. - Portfolios [Get portfolio items](https://c32jre4vsi.apidog.io/api-3547268.md): Get a list of the items in compact form in a portfolio. - Portfolios [Remove a custom field from a portfolio](https://c32jre4vsi.apidog.io/api-3547263.md): Removes a custom field setting from a portfolio. - Portfolios [Remove a portfolio item](https://c32jre4vsi.apidog.io/api-3547265.md): Remove an item from a portfolio. - Portfolios [Remove users from a portfolio](https://c32jre4vsi.apidog.io/api-3547264.md): Removes the specified list of users from members of the portfolio. - Custom Field Settings [Get a portfolio's custom fields](https://c32jre4vsi.apidog.io/api-3547267.md): Returns a list of all of the custom fields settings on a portfolio, in compact form. - Custom Field Settings [Get a project's custom fields](https://c32jre4vsi.apidog.io/api-3547266.md): Returns a list of all of the custom fields settings on a project, in compact form. Note that, as in all queries to collections which return compact representation, `opt_fields` can be used to include more data than is returned in the compact representation. See the [getting started guide on input/output options](https://developers.asana.com/docs/#input-output-options) for more information. - Project Memberships [Get a project membership](https://c32jre4vsi.apidog.io/api-3547269.md): Returns the complete project record for a single project membership. - Project Memberships [Get memberships from a project](https://c32jre4vsi.apidog.io/api-3547271.md): Returns the compact project membership records for the project. - Project Statuses [Delete a project status](https://c32jre4vsi.apidog.io/api-3547270.md): Deletes a specific, existing project status update. - Project Statuses [Get a project status](https://c32jre4vsi.apidog.io/api-3547273.md): Returns the complete record for a single status update. - Project Statuses [Get statuses from a project](https://c32jre4vsi.apidog.io/api-3547272.md): Returns the compact project status update records for all updates on the project. - Project Statuses [Create a project status](https://c32jre4vsi.apidog.io/api-3547274.md): Creates a new status update on the project. - Projects [Get multiple projects](https://c32jre4vsi.apidog.io/api-3547275.md): Returns the compact project records for some filtered set of projects. Use one or more of the parameters provided to filter the projects returned. - Projects [Create a project](https://c32jre4vsi.apidog.io/api-3547276.md): Create a new project in a workspace or team. - Projects [Delete a project](https://c32jre4vsi.apidog.io/api-3547280.md): A specific, existing project can be deleted by making a DELETE request on - Projects [Get a project](https://c32jre4vsi.apidog.io/api-3547277.md): Returns the complete project record for a single project. - Projects [Update a project](https://c32jre4vsi.apidog.io/api-3547278.md): A specific, existing project can be updated by making a PUT request on - Projects [Add a custom field to a project](https://c32jre4vsi.apidog.io/api-3547279.md): Custom fields are associated with projects by way of custom field settings. This method creates a setting for the project. - Projects [Add followers to a project](https://c32jre4vsi.apidog.io/api-3547285.md): Adds the specified list of users as followers to the project. Followers are a subset of members, therefore if the users are not already members of the project they will also become members as a result of this operation. - Projects [Add users to a project](https://c32jre4vsi.apidog.io/api-3547284.md): Adds the specified list of users as members of the project. - Projects [Duplicate a project](https://c32jre4vsi.apidog.io/api-3547289.md): Creates and returns a job that will asynchronously handle the duplication. - Projects [Remove a custom field from a project](https://c32jre4vsi.apidog.io/api-3547286.md): Removes a custom field setting from a project. - Projects [Remove followers from a project](https://c32jre4vsi.apidog.io/api-3547287.md): Removes the specified list of users from following the project, this will not affect project membership status. - Projects [Remove users from a project](https://c32jre4vsi.apidog.io/api-3547288.md): Removes the specified list of users from members of the project. - Projects [Get task count of a project](https://c32jre4vsi.apidog.io/api-3547281.md): Get an object that holds task count fields. **All fields are excluded by default**. You must [opt in](/docs/input-output-options) using `opt_fields` to get any information from this endpoint. - Projects [Get projects a task is in](https://c32jre4vsi.apidog.io/api-3547282.md): Returns a compact representation of all of the projects the task is in. - Projects [Get a team's projects](https://c32jre4vsi.apidog.io/api-3547283.md): Returns the compact project records for all projects in the team. - Projects [Create a project in a team](https://c32jre4vsi.apidog.io/api-3547290.md): Creates a project shared with the given team. - Projects [Get all projects in a workspace](https://c32jre4vsi.apidog.io/api-3547291.md): Returns the compact project records for all projects in the workspace. - Projects [Create a project in a workspace](https://c32jre4vsi.apidog.io/api-3547293.md): Returns the compact project records for all projects in the workspace. - Sections [Get sections in a project](https://c32jre4vsi.apidog.io/api-3547292.md): Returns the compact records for all sections in the specified project. - Sections [Create a section in a project](https://c32jre4vsi.apidog.io/api-3547295.md): Creates a new section in a project. - Sections [Move or Insert sections](https://c32jre4vsi.apidog.io/api-3547296.md): Move sections relative to each other. One of - Sections [Delete a section](https://c32jre4vsi.apidog.io/api-3547294.md): A specific, existing section can be deleted by making a DELETE request on - Sections [Get a section](https://c32jre4vsi.apidog.io/api-3547297.md): Returns the complete record for a single section. - Sections [Update a section](https://c32jre4vsi.apidog.io/api-3547298.md): A specific, existing section can be updated by making a PUT request on - Sections [Add task to section](https://c32jre4vsi.apidog.io/api-3547299.md): Add a task to a specific, existing section. This will remove the task from other sections of the project. - Tasks [Get tasks from a project](https://c32jre4vsi.apidog.io/api-3547300.md): Returns the compact task records for all tasks within the given project, ordered by their priority within the project. Tasks can exist in more than one project at a time. - Tasks [Get tasks from a section](https://c32jre4vsi.apidog.io/api-3547302.md): *Board view only*: Returns the compact section records for all tasks within the given section. - Tasks [Get tasks from a tag](https://c32jre4vsi.apidog.io/api-3547303.md): Returns the compact task records for all tasks with the given tag. Tasks can have more than one tag at a time. - Tasks [Get multiple tasks](https://c32jre4vsi.apidog.io/api-3547305.md): Returns the compact task records for some filtered set of tasks. Use one or more of the parameters provided to filter the tasks returned. You must specify a `project` or `tag` if you do not specify `assignee` and `workspace`. - Tasks [Create a task](https://c32jre4vsi.apidog.io/api-3547304.md): Creating a new task is as easy as POSTing to the `/tasks` endpoint with a - Tasks [Delete a task](https://c32jre4vsi.apidog.io/api-3547301.md): A specific, existing task can be deleted by making a DELETE request on - Tasks [Get a task](https://c32jre4vsi.apidog.io/api-3547308.md): Returns the complete task record for a single task. - Tasks [Update a task](https://c32jre4vsi.apidog.io/api-3547310.md): A specific, existing task can be updated by making a PUT request on the - Tasks [Set dependencies for a task](https://c32jre4vsi.apidog.io/api-3547306.md): Marks a set of tasks as dependencies of this task, if they are not already dependencies. *A task can have at most 15 dependencies*. - Tasks [Set dependents for a task](https://c32jre4vsi.apidog.io/api-3547307.md): Marks a set of tasks as dependents of this task, if they are not already dependents. *A task can have at most 30 dependents*. - Tasks [Add followers to a task](https://c32jre4vsi.apidog.io/api-3547309.md): Adds followers to a task. Returns an empty data block. - Tasks [Add a project to a task](https://c32jre4vsi.apidog.io/api-3547311.md): Adds the task to the specified project, in the optional location - Tasks [Add a tag to a task](https://c32jre4vsi.apidog.io/api-3547313.md): Adds a tag to a task. Returns an empty data block. - Tasks [Get dependencies from a task](https://c32jre4vsi.apidog.io/api-3547312.md): Returns the compact representations of all of the dependencies of a task. - Tasks [Get dependents from a task](https://c32jre4vsi.apidog.io/api-3547314.md): Returns the compact representations of all of the dependents of a task. - Tasks [Duplicate a task](https://c32jre4vsi.apidog.io/api-3547315.md): Creates and returns a job that will asynchronously handle the duplication. - Tasks [Unlink dependencies from a task](https://c32jre4vsi.apidog.io/api-3547316.md): Unlinks a set of dependencies from this task. - Tasks [Unlink dependents from a task](https://c32jre4vsi.apidog.io/api-3547317.md): Unlinks a set of dependents from this task. - Tasks [Remove followers from a task](https://c32jre4vsi.apidog.io/api-3547318.md): Removes each of the specified followers from the task if they are following. Returns the complete, updated record for the affected task. - Tasks [Remove a project from a task](https://c32jre4vsi.apidog.io/api-3547319.md): Removes the task from the specified project. The task will still exist in - Tasks [Remove a tag from a task](https://c32jre4vsi.apidog.io/api-3547320.md): Removes a tag from a task. Returns an empty data block. - Tasks [Set the parent of a task](https://c32jre4vsi.apidog.io/api-3547323.md): parent, or no parent task at all. Returns an empty data block. When using `insert_before` and `insert_after`, at most one of those two options can be specified, and they must already be subtasks of the parent. - Tasks [Get subtasks from a task](https://c32jre4vsi.apidog.io/api-3547325.md): Returns a compact representation of all of the subtasks of a task. - Tasks [Create a subtask](https://c32jre4vsi.apidog.io/api-3547324.md): Creates a new subtask and adds it to the parent task. Returns the full record for the newly created subtask. - Tasks [Get tasks from a user task list](https://c32jre4vsi.apidog.io/api-3547321.md): Returns the compact list of tasks in a user’s My Tasks list. - Tasks [Search tasks in a workspace](https://c32jre4vsi.apidog.io/api-3547322.md): To mirror the functionality of the Asana web app's advanced search feature, the Asana API has a task search endpoint that allows you to build complex filters to find and retrieve the exact data you need. - Stories [Delete a story](https://c32jre4vsi.apidog.io/api-3547326.md): Deletes a story. A user can only delete stories they have created. - Stories [Get a story](https://c32jre4vsi.apidog.io/api-3547328.md): Returns the full record for a single story. - Stories [Update a story](https://c32jre4vsi.apidog.io/api-3547330.md): Updates the story and returns the full record for the updated story. Only comment stories can have their text updated, and only comment stories and attachment stories can be pinned. Only one of `text` and `html_text` can be specified. - Stories [Get stories from a task](https://c32jre4vsi.apidog.io/api-3547327.md): Returns the compact records for all stories on the task. - Stories [Create a story on a task](https://c32jre4vsi.apidog.io/api-3547331.md): Adds a story to a task. This endpoint currently only allows for comment - Tags [Get multiple tags](https://c32jre4vsi.apidog.io/api-3547329.md): Returns the compact tag records for some filtered set of tags. Use one or more of the parameters provided to filter the tags returned. - Tags [Create a tag](https://c32jre4vsi.apidog.io/api-3547333.md): Creates a new tag in a workspace or organization. - Tags [Delete a tag](https://c32jre4vsi.apidog.io/api-3547332.md): A specific, existing tag can be deleted by making a DELETE request on - Tags [Get a tag](https://c32jre4vsi.apidog.io/api-3547334.md): Returns the complete tag record for a single tag. - Tags [Update a tag](https://c32jre4vsi.apidog.io/api-3547336.md): Updates the properties of a tag. Only the fields provided in the `data` - Tags [Get a task's tags](https://c32jre4vsi.apidog.io/api-3547335.md): Get a compact representation of all of the tags the task has. - Tags [Get tags in a workspace](https://c32jre4vsi.apidog.io/api-3547337.md): Returns the compact tag records for some filtered set of tags. Use one or more of the parameters provided to filter the tags returned. - Tags [Create a tag in a workspace](https://c32jre4vsi.apidog.io/api-3547339.md): Creates a new tag in a workspace or organization. - Team Memberships [Get team memberships](https://c32jre4vsi.apidog.io/api-3547338.md): Returns compact team membership records. - Team Memberships [Get a team membership](https://c32jre4vsi.apidog.io/api-3547340.md): Returns the complete team membership record for a single team membership. - Team Memberships [Get memberships from a team](https://c32jre4vsi.apidog.io/api-3547341.md): Returns the compact team memberships for the team. - Team Memberships [Get memberships from a user](https://c32jre4vsi.apidog.io/api-3547342.md): Returns the compact team membership records for the user. - Users [Get users in a team](https://c32jre4vsi.apidog.io/api-3547344.md): Returns the compact records for all users that are members of the team. - Users [Get multiple users](https://c32jre4vsi.apidog.io/api-3547345.md): Returns the user records for all users in all workspaces and organizations accessible to the authenticated user. Accepts an optional workspace ID parameter. - Users [Get a user](https://c32jre4vsi.apidog.io/api-3547343.md): Returns the full user record for the single user with the provided ID. - Users [Get a user's favorites](https://c32jre4vsi.apidog.io/api-3547347.md): Returns all of a user's favorites in the given workspace, of the given type. - Users [Get users in a workspace or organization](https://c32jre4vsi.apidog.io/api-3547346.md): Returns the compact records for all users in the specified workspace or organization. - Time Periods [Get time periods](https://c32jre4vsi.apidog.io/api-3547351.md): Returns compact time period records. - Time Periods [Get a time period](https://c32jre4vsi.apidog.io/api-3547348.md): Returns the full record for a single time period. - User Task Lists [Get a user task list](https://c32jre4vsi.apidog.io/api-3547349.md): Returns the full record for a user task list. - User Task Lists [Get a user's task list](https://c32jre4vsi.apidog.io/api-3547350.md): Returns the full record for a user's task list. - Workspace Memberships [Get workspace memberships for a user](https://c32jre4vsi.apidog.io/api-3547352.md): Returns the compact workspace membership records for the user. - Workspace Memberships [Get a workspace membership](https://c32jre4vsi.apidog.io/api-3547354.md): Returns the complete workspace record for a single workspace membership. - Workspace Memberships [Get the workspace memberships for a workspace](https://c32jre4vsi.apidog.io/api-3547353.md): Returns the compact workspace membership records for the workspace. - Webhooks [Get multiple webhooks](https://c32jre4vsi.apidog.io/api-3547355.md): Get the compact representation of all webhooks your app has registered for the authenticated user in the given workspace. - Webhooks [Establish a webhook](https://c32jre4vsi.apidog.io/api-3547356.md): Establishing a webhook is a two-part process. First, a simple HTTP POST - Webhooks [Delete a webhook](https://c32jre4vsi.apidog.io/api-3547357.md): This method *permanently* removes a webhook. Note that it may be possible to receive a request that was already in flight after deleting the webhook, but no further requests will be issued. - Webhooks [Get a webhook](https://c32jre4vsi.apidog.io/api-3547359.md): Returns the full record for the given webhook. - Workspaces [Get multiple workspaces](https://c32jre4vsi.apidog.io/api-3547360.md): Returns the compact records for all workspaces visible to the authorized user. - Workspaces [Get a workspace](https://c32jre4vsi.apidog.io/api-3547358.md): Returns the full workspace record for a single workspace. - Workspaces [Update a workspace](https://c32jre4vsi.apidog.io/api-3547361.md): A specific, existing workspace can be updated by making a PUT request on the URL for that workspace. Only the fields provided in the data block will be updated; any unspecified fields will remain unchanged. - Workspaces [Add a user to a workspace or organization](https://c32jre4vsi.apidog.io/api-3547362.md): Add a user to a workspace or organization. - Workspaces [Remove a user from a workspace or organization](https://c32jre4vsi.apidog.io/api-3547364.md): Remove a user from a workspace or organization. - Typeahead [Get objects via typeahead](https://c32jre4vsi.apidog.io/api-3547363.md): Retrieves objects in the workspace based via an auto-completion/typeahead