Allocations

Get an allocation

Changed on

Returns the complete allocation record for a single allocation.

get/allocations/{allocation_gid}

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/allocations/{allocation_gid}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token)

Query parameters

opt_fieldsstring[]

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.

Response

Successfully retrieved the record for a single allocation.

Example response

{
  "data": {
    "gid": "12345",
    "resource_type": "allocation",
    "start_date": "2024-02-28",
    "end_date": "2024-02-28",
    "effort": {
      "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": "default_project"
    },
    "resource_subtype": "project_allocation"
  }
}

Changes

  • 2aac685725ecRevision changes
    • info

      added the enum value parent.resource_subtype to the property items/ of the query request parameter opt_fields

    • info

      added the optional property /// to the response with the status