Graph exports
Availability
Graph exports are currently available to users in an Enterprise/Enterprise+ organization.
A graph export object represents a request to export the data about objects starting from a parent object. The parent object can be a team, portfolio, or project.
➡️ To get started with graph exports, please first review this documentation.
Properties
The following is a reference of properties exposed per resource_type:
portfolio
portfolio| Property | Description |
|---|---|
| gid | Globally unique identifier of the resource, as a string. |
| name | The name of the portfolio. |
| archived | True if the portfolio is archived, false if not. |
| created_at | The time at which this resource was created. |
| created_by.gid | Globally unique identifier of the resource, as a string. |
| created_by.name | The user's name. |
| created_by.resource_type | The base type of this resource. |
| current_status_update.created_at | The time at which this resource was created. |
| current_status_update.created_by.gid | Globally unique identifier of the resource, as a string. |
| current_status_update.created_by.name | The user's name. |
| current_status_update.gid | Globally unique identifier of the resource, as a string. |
| current_status_update.resource_type | The base type of this resource. |
| current_status_update.status_type | Status of the status update. |
| current_status_update.text | The text of the status update. |
| current_status_update.title | The title of the status update. |
| custom_fields.date_value | Only relevant for custom fields of type date. |
| custom_fields.enum_value | Only relevant for custom fields of type enum |
| custom_fields.multi_enum_values | Only relevant for custom fields of type multi_enum |
| custom_fields.name | The name of the custom field. |
| custom_fields.number_value | Only relevant for custom fields of type number |
| custom_fields.people_value.email | Only relevant for custom fields of type people |
| custom_fields.text_value | Only relevant for custom fields of type text |
| custom_fields.type | The type of the custom field. Must be one of the given values: date, enum, multi_enum, number, people, text |
| default_access_level | The default access level when inviting new members to the portfolio |
| due_on | The localized day on which this portfolio is due. This takes a date with format-MM-DD. |
| members.gid | Globally unique identifier of the resource, as a string. |
| members.name | The user's name. |
| members.resource_type | The base type of this resource. |
| owner.gid | Globally unique identifier of the resource, as a string |
| owner.name | The user's name |
| owner.resource_type | The base type of this resource. |
| permalink_url | A url that points directly to the object within Asana. |
| privacy_setting | The privacy setting of the portfolio. |
| public | True if the portfolio is public to its workspace members. |
| resource_type | The base type of this resource. |
| start_on | The day on which work for this portfolio begins, or null if the project has no start date |
| workspace.gid | Globally unique identifier of the resource, as a string |
| workspace.name | The name of the workspace. |
| workspace.resource_type | The base type of this resource. |
project
project| Property | Description |
|---|---|
| gid | Globally unique identifier of the resource, as a string. |
| resource_type | The base type of this resource. |
| name | The name of the project. |
| archived | True if the project is archived, false if not. |
| color | Color of the project. |
| created_at | The time at which this resource was created. |
| current_status_update.gid | Globally unique identifier of the resource, as a string. |
| current_status_update.created_at | The time at which this resource was created. |
| current_status_update.created_by.gid | Globally unique identifier of the resource, as a string. |
| current_status_update.created_by.name | The user's name. |
| current_status_update.resource_type | The base type of this resource. |
| current_status_update.status_type | Status of the status update. |
| current_status_update.text | The text of the status update. |
| current_status_update.title | The title of the status update. |
| default_view | The default view (list, board, calendar, or timeline) of a project. |
| due_on | The localized day on which this project is due. This takes a date with format YYYY-MM-DD. |
| custom_fields.name | The name of the custom field. |
| custom_fields.type | The type of the custom field. Must be one of the given values: date, enum, multi_enum, number, people, text |
| custom_fields.date_value | Only relevant for custom fields of type date. |
| custom_fields.enum_value | Only relevant for custom fields of type enum |
| custom_fields.multi_enum_values | Only relevant for custom fields of type multi_enum |
| custom_fields.number_value | Only relevant for custom fields of type number |
| custom_fields.text_value | Only relevant for custom fields of type text |
| custom_fields.people_value.email | Only relevant for custom fields of type people |
| members.gid | Globally unique identifier of the resource, as a string. |
| members.resource_type | The base type of this resource. |
| members.name | The user's name. |
| modified_at | The time at which this project was last modified |
| notes | Free-form textual information associated with the project |
| owner.gid | Globally unique identifier of the resource, as a string |
| owner.resource_type | The base type of this resource. |
| owner.name | The user's name |
| start_on | The day on which work for this project begins, or null if the project has no start date |
| minimum_access_level_for_customization | The minimum access level needed for project members to modify this project's workflow and appearance. |
| minimum_access_level_for_sharing | The minimum access level needed for project members to share the project and manage project memberships. |
| completed_at | The time at which this project was completed, or null if the project is not completed. |
| completed_by.gid | Globally unique identifier of the resource, as a string. |
| completed_by.resource_type | The base type of this resource. |
| completed_by.name | The user's name |
| workspace.gid | Globally unique identifier of the resource, as a string |
| workspace.resource_type | The base type of this resource. |
| workspace.name | The name of the workspace. |
| team.gid | Globally unique identifier of the resource, as a string. |
| team.resource_type | The base type of this resource. |
| team.name | The name of the team. |
| icon | The icon for a project. |
| permalink_url | A url that points directly to the object within Asana. |
| default_access_level | The default access level when inviting new members to the portfolio |
| privacy_setting | The privacy setting of the project. |
task
task| Property | Description |
|---|---|
| gid | Globally unique identifier of the resource, as a string. |
| name | The name of the task. |
| actual_time_minutes | This value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. |
| approval_status | Reflects the approval status of this task |
| assignee.gid | Globally unique identifier of the resource, as a string. |
| assignee.name | The users name |
| assignee.email | The users email |
| assignee_status | Scheduling status of this task for the user it is assigned to |
| completed | True if the task is currently marked complete, false if not. |
| completed_at | The time at which this task was completed, or null if the task is incomplete. |
| completed_by.gid | Globally unique identifier of the resource, as a string. |
| completed_by.name | The users name |
| completed_by.email | The users email |
| created_by.gid | Globally unique identifier of the resource, as a string. |
| created_by.name | The users name |
| created_by.email | The users email |
| created_at | The time at which this resource was created. |
| custom_fields.gid | Globally unique identifier of the resource, as a string. |
| custom_fields.name | The name of the custom field. |
| custom_fields.type | The type of the custom field. |
| custom_fields.value | Value of the custom field. |
| dependencies.gid | Globally unique identifier of the resource, as a string. |
| dependents.gid | Globally unique identifier of the resource, as a string. |
| due_at | The UTC date and time on which this task is due, or null if the task has no due time. |
| due_on | The localized date on which this task is due, or null if the task has no due date |
| memberships.section.gid | Globally unique identifier of the resource, as a string. |
| memberships.section.name | The name of the section |
| modified_at | The time at which this task was last modified. |
| num_likes | The number of users who have liked this task. |
| num_subtasks | The number of subtasks on this task. |
| parent.gid | Globally unique identifier of the resource, as a string. |
| permalink_url | A url that points directly to the object within Asana. |
| projects.gid | Globally unique identifier of the resource, as a string. |
| projects.name | The name of the project |
| resource_subtype | The subtype of this resource. Must be one of the given values: task, milestone, approval, custom |
| resource_type | The type of resource |
| start_at | Date and time on which work begins for the task, or null if the task has no start time. |
| start_on | The day on which work begins for the task , or null if the task has no start date. |
| tags.gid | Globally unique identifier of the resource, as a string. |
| tags.name | The name of the tag |
| workspace.gid | Globally unique identifier of the resource, as a string. |
| workspace.name | The name of the workspace |
section
section| Property | Description |
|---|---|
| gid | Globally unique identifier of the resource, as a string. |
| resource_type | The type of resource |
| name | The name of the section |
| created_at | The time at which this resource was created. |
| project.gid | Globally unique identifier of the resource, as a string. |
| project.resource_type | The type of resource |
portfolio_to_portfolio
portfolio_to_portfolio| Property | Description |
|---|---|
| resource_type | The type of resource |
| portfolio.gid | Globally unique identifier of the resource, as a string. |
| portfolio.name | The name of the portfolio |
| portfolio.resource_type | The type of resource |
| child_portfolio.gid | Globally unique identifier of the resource, as a string. |
| child_portfolio.name | The name of the child portfolio |
| child_portfolio.resource_type | The type of resource |
project_to_portfolio
project_to_portfolio| Property | Description |
|---|---|
| resource_type | The type of resource |
| project.gid | Globally unique identifier of the resource, as a string. |
| project.name | The name of the project |
| project.resource_type | The type of resource |
| portfolio.gid | Globally unique identifier of the resource, as a string. |
| portfolio.name | The name of the portfolio |
| portfolio.resource_type | The type of resource |
allocation
allocation| Property | Description |
|---|---|
| gid | Globally unique identifier of the resource, as a string. |
| resource_type | The base type of this resource. |
| start_date | The localized day on which the allocation starts. |
| end_date | The localized day on which the allocation ends. |
| effort.type | The units used for tracking effort on an allocation, either "hours" or "percent". |
| effort.value | The numeric effort value on the allocation. |
| assignee.gid | Globally unique identifier of the resource, as a string. |
| assignee.resource_type | The base type of this resource. |
| assignee.name | The name of allocation resource. |
| created_by.gid | Globally unique identifier of the resource, as a string. |
| created_by.resource_type | The base type of this resource. |
| created_by.name | The user's name. |
| parent.gid | Globally unique identifier of the resource, as a string. |
| parent.resource_type | The base type of this resource. |
| parent.name | 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 | The subtype of the allocation. |
time_tracking_entry
time_tracking_entry| Property | Description |
|---|---|
| gid | Globally unique identifier of the resource, as a string. |
| resource_type | The base type of this resource. |
| created_by.gid | Globally unique identifier of the resource, as a string. |
| created_by.name | The user's name. |
| attributable_to.gid | Globally unique identifier of the resource, as a string. |
| attributable_to.resource_type | The base type of this resource. |
| attributable_to.name | Name of the project. |
| duration_minutes | Time in minutes tracked by the entry. |
| entered_on | The day that this entry is logged on. |
| task.gid | Globally unique identifier of the resource, as a string. |
goal
goal| Property | Description |
|---|---|
| gid | Globally unique identifier of the resource, as a string. |
| resource_type | The base type of this resource. |
| name | The name of the goal. |
| notes | Free-form textual information associated with the goal (i.e. its description). |
| due_on | The localized day on which this goal is due. This takes a date with format YYYY-MM-DD. |
| start_on | The day on which work for this goal begins, or null if the goal has no start date. This takes a date with YYYY-MM-DD format, and cannot be set unless there is an accompanying due date. |
| is_workspace_level | Conditional. This property is only present when the workspace provided is an organization. Whether the goal belongs to the workspace (and is listed as part of the workspace’s goals) or not. If it isn’t a workspace-level goal, it is a team-level goal, and is associated with the goal’s team. |
| team.gid | Globally unique identifier of the resource, as a string. |
| team.resource_type | The base type of this resource. |
| team.name | The name of the team. |
| workspace.gid | Globally unique identifier of the resource, as a string. |
| workspace.resource_type | The base type of this resource. |
| workspace.name | The name of the workspace. |
| time_period.gid | Globally unique identifier of the resource, as a string. |
| time_period.resource_type | The base type of this resource. |
| time_period.end_on | The localized end date of the time period in YYYY-MM-DD format. |
| time_period.start_on | The localized start date of the time period in YYYY-MM-DD format. |
| time_period.period | The cadence and index of the time period. |
| time_period.display_name | A string representing the cadence code and the fiscal year. |
| metric.gid | Globally unique identifier of the resource, as a string. |
| metric.resource_type | The base type of this resource. |
| metric.resource_subtype | The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning. |
| metric.precision | Conditional. Only relevant for goal metrics of type Number. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive. For percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%. |
| metric.unit | A supported unit of measure for the goal metric, or none. |
| metric.currency_code | ISO 4217 currency code to format this custom field. This will be null if the unit is not currency. |
| metric.initial_number_value | This number is the start value of a goal metric of type number. |
| metric.target_number_value | This number is the end value of a goal metric of type number. This number cannot equal initial_number_value. |
| metric.current_number_value | This number is the current value of a goal metric of type number. |
| metric.current_display_value | This string is the current value of a goal metric of type string. |
| metric.progress_source | This field defines how the progress value of a goal metric is being calculated. A goal's progress can be provided manually by the user, calculated automatically from contributing subgoals, projects, or tasks, or managed by an integration with an external data source, such as Salesforce. |
| metric.is_custom_weight | Conditional. Only relevant if metric.progress_source is one of subgoal_progress, project_task_completion, project_milestone_completion, or task_completion. If true, we use the supporting object's custom weight to calculate the goal's progress. If false, we treat all supporting objects as equally weighted |
| metric.can_manage | Conditional. Only relevant for progress_source of type external. This boolean indicates whether the requester has the ability to update the current value of this metric. This returns true if the external metric was created by the requester, false otherwise. |
| owner.gid | Globally unique identifier of the resource, as a string. |
| owner.resource_type | The base type of this resource. |
| owner.name | The user's name. |
| current_status_update.gid | Globally unique identifier of the resource, as a string. |
| current_status_update.resource_type | The base type of this resource. |
| current_status_update.title | The title of the status update. |
| current_status_update.text | The text of the status update. |
| current_status_update.resource_subtype | The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning. The resource_subtypes for status objects represent the type of their parent. |
| current_status_update.status_type | Status of the status update. |
| current_status_update.created_at | The time at which this resource was created. |
| current_status_update.created_by.gid | Globally unique identifier of the resource, as a string. |
| current_status_update.created_by.name | The user's name. |
| status | The current status of this goal. When the goal is open, its status can be green, yellow, and red to reflect "On Track", "At Risk", and "Off Track", respectively. When the goal is closed, the value can be missed, achieved, partial, or dropped. |
goal_to_goal
goal_to_goal| Property | Description |
|---|---|
| resource_type | The base type of this resource. |
| parent.gid | Globally unique identifier of the resource, as a string. |
| parent.name | The name of the resource. |
| parent.resource_type | The base type of this resource. |
| child.gid | Globally unique identifier of the resource, as a string. |
| child.name | The name of the resource. |
| child.resource_type | The base type of this resource. |
goal_to_portfolio
goal_to_portfolio| Property | Description |
|---|---|
| resource_type | The base type of this resource. |
| parent.gid | Globally unique identifier of the resource, as a string. |
| parent.name | The name of the resource. |
| parent.resource_type | The base type of this resource. |
| child.gid | Globally unique identifier of the resource, as a string. |
| child.name | The name of the resource. |
| child.resource_type | The base type of this resource. |
goal_to_project
goal_to_project| Property | Description |
|---|---|
| resource_type | The base type of this resource. |
| parent.gid | Globally unique identifier of the resource, as a string. |
| parent.name | The name of the resource. |
| parent.resource_type | The base type of this resource. |
| child.gid | Globally unique identifier of the resource, as a string. |
| child.name | The name of the resource. |
| child.resource_type | The base type of this resource. |
goal_to_task
goal_to_task| Property | Description |
|---|---|
| resource_type | The base type of this resource. |
| parent.gid | Globally unique identifier of the resource, as a string. |
| parent.name | The name of the resource. |
| parent.resource_type | The base type of this resource. |
| child.gid | Globally unique identifier of the resource, as a string. |
| child.name | The name of the resource. |
| child.resource_type | The base type of this resource. |
Updated 17 days ago