📘
Accessing allocation endpoints
Allocations are available to all Enterprise and above customers

An allocation object represents how much of a resource (e.g. person, team) is dedicated to a specific work object (e.g. project, portfolio) over a specific period of time. The effort value of an allocation object can be a percentage or number of hours.

Capacity planning

Capacity planning in Asana leverages the allocations API to track and visualize user assignments across projects. By using allocation objects, Asana provides a comprehensive view of resource distribution. Each allocation can be represented as either a percentage or a number of hours, displayed as colored bars in the capacity plan UI.

Allocations are managed at the domain level, while capacity plans offer a filtered perspective of this data. When a team member is added to a capacity plan, their existing allocations from various projects are automatically fetched and shown. Any changes made to a user’s allocations—such as time adjustments or reassignments—are instantly reflected across all relevant capacity plans, ensuring real-time accuracy.

For users needing advanced reporting capabilities, the allocations API allows for data export to integrate with external reporting tools like Tableau or Power BI, providing flexibility for in-depth analysis.

Allocation

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`start_date`	string (date)	The localized day on which the allocation starts.
`end_date`	string (date)	The localized day on which the allocation ends.
`effort`	object	The amount of time associated with the allocation, represented as a percentage or number of hours.
`effort.type`	string	The units used for tracking effort on an allocation, either "hours" or "percent". Click to show all enum values `hours` `percent`
`effort.value`	number	The numeric effort value on the allocation.
`assignee`	object	The user or placeholder assigned to the allocation.
`assignee.gid`	string	Globally unique identifier of the resource, as a string.
`assignee.resource_type`	string	The base type of this resource.
`assignee.name`	string	The name of allocation resource.
`created_by`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`created_by.gid`	string	Globally unique identifier of the resource, as a string.
`created_by.resource_type`	string	The base type of this resource.
`created_by.name`	string	Read-only except when same user as requester. The user's name.
`parent`	object	A project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.
`parent.gid`	string	Globally unique identifier of the resource, as a string.
`parent.resource_type`	string	The base type of this resource.
`parent.name`	string	Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
`resource_subtype`	string	The subtype of the allocation.

Example JSON for Allocation:

{
  "gid": "12345",
  "resource_type": "allocation",
  "start_date": "2024-02-28",
  "end_date": "2024-02-28",
  "effort": {
    "type": "example string",
    "value": 50
  },
  "assignee": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "created_by": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "parent": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  },
  "resource_subtype": "project_allocation"
}