Get the complete definition of a custom field’s metadata. Since custom fields can be defined for one of a number of types, and these types have different data and behaviors, there are fields that are relevant to a particular type. For instance, as noted above, enum_options is only relevant for the enum type and defines the set of choices that the enum could represent. The examples below show some of these type-specific custom field definitions.
Returns the complete goal record for a single goal.
Returns the complete updated goal relationship record for a single goal relationship.
Returns the full record for a job.
Returns the complete portfolio record for a single portfolio.
Returns the complete portfolio record for a single portfolio membership.
Returns a list of all of the custom fields settings on a portfolio, in compact form.
Returns the complete project record for a single project.
Get the full record for a project brief.
Returns the complete project record for a single project membership.
*Deprecated: new integrations should prefer the `/status_updates/{status_gid}` route.* Returns the complete record for a single status update.
Returns the complete project template record for a single project template.
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.
Returns the complete record for a single section.
Returns the complete record for a single status update.
Returns the full record for a single story.
Returns the complete tag record for a single tag.
Returns the complete task record for a single task.
Get a compact representation of all of the tags the task has.
Returns the full record for a single team.
Returns the complete team membership record for a single team membership.
Returns the compact project template records for all project templates in the team.
Returns the compact project records for all projects in the team.
Returns the full record for a single time period.
Returns all of a user's favorites in the given workspace, of the given type. Results are given in order (The same order as Asana's sidebar).
Returns a list of the compact representation of all of the custom fields in a workspace.
Returns the compact project records for all projects in the workspace. *Note: This endpoint may timeout for large domains. Prefer the `/teams/{team_gid}/projects` endpoint.*
Get the full record for a single attachment.
Returns the compact records for all attachments on the object. There are three possible `parent` values for this request: `project`, `project_brief`, and `task`. For a project, an attachment refers to a file uploaded to the "Key resources" section in the project Overview. For a project brief, an attachment refers to inline files in the project brief itself. For a task, an attachment refers to a file directly associated to that task.
Retrieve the audit log events that have been captured in your domain. This endpoint will return a list of [AuditLogEvent](/docs/audit-log-event) objects, sorted by creation time in ascending order. Note that the Audit Log API captures events from October 8th, 2021 and later. Queries for events before this date will not return results. There are a number of query parameters (below) that can be used to filter the set of [AuditLogEvent](/docs/audit-log-event) objects that are returned in the response. Any combination of query parameters is valid. When no filters are provided, all of the events that have been captured in your domain will match. The list of events will always be [paginated](/docs/pagination). The default limit is 1000 events. The next set of events can be retrieved using the `offset` from the previous response. If there are no events that match the provided filters in your domain, the endpoint will return `null` for the `next_page` field. Querying again with the same filters may return new events if they were captured after the last request. Once a response includes a `next_page` with an `offset`, subsequent requests can be made with the latest `offset` to poll for new events that match the provided filters. When no `offset` is provided, the response will begin with the oldest events that match the provided filters. It is important to note that [AuditLogEvent](/docs/audit-log-event) objects will be permanently deleted from our systems after 90 days. If you wish to keep a permanent record of these events, we recommend using a SIEM tool to ingest and store these logs.
Returns the compact representations of all of the dependencies of a task.
Returns the compact representations of all of the dependents of a task.
Returns the full record for all events that have occurred since the sync token was created. A `GET` request to the endpoint `/[path_to_resource]/events` can be made in lieu of including the resource ID in the data for the request. Asana limits a single sync token to 100 events. If more than 100 events exist for a given resource, `has_more: true` will be returned in the response, indicating that there are more events to pull. *Note: The resource returned will be the resource that triggered the event. This may be different from the one that the events were requested for. For example, a subscription to a project will contain events for tasks contained within the project.*
Returns compact goal relationship records.
Returns the compact portfolio membership records for the portfolio.
Returns the compact project membership records for the project.
Returns the compact team memberships for the team.
Returns the compact team membership records for the user.
Returns a list of portfolio memberships in compact representation. You must specify `portfolio`, `portfolio` and `user`, or `workspace` and `user`.
Returns a list of the portfolios in compact representation that are owned by the current API user.
Returns the compact project template records for all project templates in the given team or workspace.
Returns the compact project records for some filtered set of projects. Use one or more of the parameters provided to filter the projects returned. *Note: This endpoint may timeout for large domains. Try filtering by team!*
Returns the compact tag records for some filtered set of tags. Use one or more of the parameters provided to filter the tags returned.
Returns a compact representation of all of the parent goals of a goal.
Get a list of the items in compact form in a portfolio.
Returns a compact representation of all of the projects the task is in.
Returns the compact records for all sections in the specified project.
Returns the compact status update records for all updates on the object.
*Deprecated: new integrations should prefer the `/status_updates` route.* Returns the compact project status update records for all updates on the project.
Returns the compact records for all stories on the task.
Returns a compact representation of all of the subtasks of a task.
Returns the compact tag records for some filtered set of tags. Use one or more of the parameters provided to filter the tags returned.
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. This endpoint has an additional [rate limit](/docs/standard-rate-limits) and each field counts especially high against our [cost limits](/docs/cost-limits). Milestones are just tasks, so they are included in the `num_tasks`, `num_incomplete_tasks`, and `num_completed_tasks` counts.
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.
*Board view only*: Returns the compact section records for all tasks within the given section.
Returns the compact task records for all tasks with the given tag. Tasks can have more than one tag at a time.
Returns the compact list of tasks in a user’s My Tasks list. *Note: Access control is enforced for this endpoint as with all Asana API endpoints, meaning a user’s private tasks will be filtered out if the API-authenticated user does not have access to them.* *Note: Both complete and incomplete tasks are returned by default unless they are filtered out (for example, setting `completed_since=now` will return only incomplete tasks, which is the default view for “My Tasks” in Asana.)*
Returns compact team membership records.
Returns the compact records for all teams to which the given user is assigned.
Returns the compact records for all teams in the workspace visible to the authorized user.
Tell us which provider you need, and we will ship it in the registry.
Point swirls add at an OpenAPI or GraphQL spec. Typed actions for any API you hold credentials for, today.