Asana Connector Objects

note: This feature is a Beta Service. A customer may opt to try a Beta Service in its sole discretion. Any use of the Beta Service is subject to the applicable Beta Services Terms provided at Agreements and Terms. If you have questions or feedback about this Beta Service, contact the Data 360 Connector team at datacloud-connectors-beta@salesforce.com.

Objects Supported

Name Description
Allocations To Create, Update, Delete and Query the Allocations table.
Attachments To Delete and Query from the Attachments in the tasks.
CustomFields To view the Custom Fields in the project or workspace.
Events To view the events in projects and tasks.
GoalMembership To Create, Delete and Query memberships in the Goal.
Goals To Create, Update, Delete and Query the Goals table.
PortfolioItems To Create, delete, and Query Items in the Portfolio.
PortfolioMembership To Create, Delete and Query memberships in the Portfolio.
Portfolios To Create, update, delete, and query from Portfolios table.
ProjectFollowers To view the Project follower details.
ProjectMembership To Create, Delete and Query memberships in the Project.
Projects To Create, Update, Delete and Query the Projects table.
ProjectStatuses To Create, Delete and Query from ProjectStatuses table. A project status is an update on the progress of a particular project, and is sent out to all project followers when created.
ProjectTemplates TO get ProjectTemplates in the Team or workspace.
Sections To Create, Update, Delete, and Query from Sections table. A section is a subdivision of a project that groups tasks together.
StatusUpdates A status update is an update on the progress of a particular object, and is sent out to all followers when created.
Stories To Create, Update, Delete and Query from stories table. A story represents an activity associated with an object in the Asana system. Stories are generated by the system whenever users take actions such as creating or assigning tasks, or moving tasks between projects.
SubTasks To Create, update, delete, and query from SubTasks table.
Tags To Create, Update and Query from Tags table. A tag is a label that can be attached to any task in Asana. It exists in a single workspace.
TaskDependencies To query all of the dependencies of a task.
TaskDependents To query all of the dependents of a task.
Tasks To Create, Update, Delete and Query from Tasks table.
TaskStatuses Get task count of a project.
TaskTemplates To Delete and Query the task templates.
TeamMembership To represents a users connection to a team.
Teams A team is used to group related projects and people together within an organization. Each project in an organization is associated with a team.
TimePeriods To query time period records or full record for a single time period.
TimeTrackingEntries Returns time tracking entries for a given task.
Users To view the users details.
UserTaskList Generated schema file.
WorkspaceMembership To Create, Delete and Query memberships in the Workspace.
Workspaces To Update and Query from Workspaces table. A workspace is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.

Allocations

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the user.
ResourceType String True No The base type of this resource.
StartDate Date False No The localized day on which the allocation starts.
EndDate Date False No The localized day on which the allocation ends.
EffortType String False No The units used for tracking effort on an allocation, either
EffortValue Integer False No The numeric effort value on the allocation.
Assignee String False Users.Id No Globally unique identifier of the resource, as a string.
AssigneeName String True No The name of allocation resource.
CreatedById String True No Globally unique identifier of the resource, as a string.
CreatedByName String True No Read-only except when same user as requester. The user's name.
Parent String False Projects.Id No Globally unique identifier of the resource, as a string.
ParentName String True No 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.
ResourceSubType String True No The subtype of the allocation.
WorkspaceId String True Workspaces.Id No Globally unique ID of the workspace.

Return to Top

Attachments

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the attachment.
Name String True No The name of the file.
Host String True No The service hosting the attachment. Valid values are asana, dropbox, gdrive and box.
CreatedAt Datetime True No The time at which this attachment was uploaded.
ViewURL String True No The URL where the attachment can be viewed, which may be friendlier to users in a browser than just directing them to a raw file.
DownloadURL String True No May be null if the attachment is hosted by box. If present, this URL may only be valid for 1 hour from the time of retrieval. You should avoid persisting this URL somewhere and just refresh it on demand to ensure you do not keep stale URLs.
TaskId String True Tasks.Id No The task this attachment is attached to.
ResourceType String True No The resource type of this resource.
ResourceSubtype String True No The service hosting the attachment. Valid values are asana, dropbox, gdrive, onedrive, box, vimeo, and external.
PermanentURL String True No PermanentURL
Size Integer True No The size of the attachment in bytes. Only present when the resource_subtype is asana.
ConnectedToApp Boolean True No Whether the attachment is connected to the app making the request for the purposes of showing an app components widget. Only present when the resource_subtype is external or gdrive.

Return to Top

CustomFields

Name Type ReadOnly References FilterOnly Description
Id String True No Globally unique identifier of the resource.
Name String True No The name of the custom field.
Description String True No The description of the custom field.
Type String True No The type of the custom field. It must be one of the given values.
ProjectId String True Projects.Id No Globally unique Id of the project.
ProjectName String True No Name of the project.
IsImportant Boolean True No Name of the project.
Format String True No The format of the custom field.
TextValue String True No The value of a text custom field.
NumberValue Double True No The value of a number custom field.
Precision Integer True No Only relevant for custom fields of type 'Number'. This field specifies the number of digits after the decimal to round to.
CurrencyCode String True No The currency code for this custom field. This will be null if the format is not currency.
EnumOptions String True No Array of projects this task is associated with and the section it is in.
CreatedBy String True No Globally unique user identifier.
CreatedByName String True No The user's name.
IsGlobaltoWorkspace Boolean True No A boolean flag that specifies whether this custom field is available to every container in the workspace.
HasNotificationsEnabled Boolean True No A boolean flag that specifies whether a follower of a task with this field should receive inbox notifications about changes in this field.
WorkspaceId String True Workspaces.Id No Globally unique ID of the workspace.

Return to Top

Events

Name Type ReadOnly References FilterOnly Description
ResourceId [KEY] String True No The resource GID for the events were requested for.
ResourceType String True No The resource type for the events were requested for.
ResourceSubType String True No The resource sub type for the events were requested for.
ResourceName String True No The resource name for the events were requested for.
Parent String True No For added/removed events, the parent that resource was added to or removed from. null for other event types.
CreatedAt Datetime True No The timestamp when the event occurred.
UserId String True No The event may be triggered by a different user GID than the subscriber.
UserFullname String True No The event may be triggered by a different user name than the subscriber.
Action String True No The type of action taken that triggered the event.
ChangeField String True No The name of the field that has changed in the resource.
ChangeAction String True No The type of action taken on the field which has been changed. This can be one of changed, added, or removed depending on the nature of the change.
ChangeNewValue String True No This property is only present when the value of the event's change.action is changed and the new_value is an Asana resource. This will be only the gid and resource_type of the resource when the events come from webhooks.
ChangeAddedValue String True No This property is only present when the value of the event's change.action is added and the added_value is an Asana resource. This will be only the gid and resource_type of the resource when the events come from webhooks.
ChangeRemovedValue String True No This property is only present when the value of the event's change.action is removed and the removed_value is an Asana resource. This will be only the gid and resource_type of the resource when the events come from webhook.

Return to Top

GoalMembership

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique Id of the goal membership.
GoalId String False Goals.Id No Globally unique identifier for goal.
GoalName String True No The name of the goal.
GoalOwnerGid String True No Globally unique identifier of the goal owner.
GoalOwnerName String True No The name of the goal owner.
Role String True No Describes if the member is a commenter or editor in goal.
MemberId String False No Globally unique identifier of the member of the goal.
MemberName String True No The name of the member.
MemberResourceType String True No The type of the member (team or user).
ResourceSubtype String True No The type of membership.
ResourceType String True No The base type of this resource.

Return to Top

Goals

Name Type ReadOnly References FilterOnly Description
Id [KEY] String False No Globally unique Id of the goal.
ResourceType String True No The base type of this resource.
Name String False No The name of the goal.
OwnerId String False No Globally unique Id of the owner.
OwnerName String True No The name of the owner.
OwnerResourceType String True No The base type of this resource.
DueOn Date False No The localized day on which this goal is due.
StartOn Date False No The day on which work for this goal begins.
CurrentStatusUpdateId String True No Globally unique identifier of the resource, as a string.
CurrentStatusUpdateResourceSubtype String True No The base type of this resource.
CurrentStatusUpdateResourceType String True No 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.
CurrentStatusUpdateResourceTitle String True No The title of the status update.
Followers String False No Array of users who are members of this goal.
IsWorkspaceLevel Boolean False No Whether the goal belongs to the workspace.
Liked Boolean False No True if the goal is liked by the authorized user, false if not.
Likes String True No Array of likes for users who have liked this goal.
MetricId String True No Globally unique identifier of the metric.
MetricCurrencyCode String True No ISO 4217 currency code to format this custom field. This will be null if the unit is not currency.
MetricCurrentDisplayValue String True No This string is the current value of a goal metric of type string.
MetricCurrentNumberValue Integer True No This number is the current value of a goal metric of type number.
MetricInitialNumberValue Integer True No This number is the start value of a goal metric of type number.
MetricPrecision Integer True No 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.
MetricProgressSource String True No This field defines how the progress value of a goal metric is being calculated.
MetricResourceSubtype String True No The subtype of this resource.
MetricResourceType String True No The base type of this resource.
MetricTargetNumberValue Integer True No This number is the end value of a goal metric of type number. This number cannot equal initial_number_value.
MetricUnit String True No A supported unit of measure for the goal metric, or none.
Notes String False No Free-form textual information associated with the goal.
HtmlNotes String False No The notes of the goal with formatting as HTML.
NumLikes Integer True No The number of users who have liked this goal.
Status String False No 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.
TeamId String False Teams.Id No Globally unique identifier of the team.
TeamName String True No The name of the team.
TimePeriodId String False No Globally unique identifier of the time period.
TimePeriodDisplayName String True No A string representing the cadence code and the fiscal year.
TimePeriodStartOn Date True No The localized end date of the time period.
TimePeriodEndOn Date True No The localized end date of the time period.
TimePeriodPeriod String True No The cadence and index of the time period. The value is one of: FY, H1, H2, Q1, Q2, Q3, or Q4.
WorkspaceId String False Workspaces.Id No Globally unique identifier of the workspace.
WorkspaceName String True No The name of the workspace.

Return to Top

PortfolioItems

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the Portfolio Item.
Name String True No Name of the Item.
PortfolioId [KEY] String True Portfolios.Id No Globally unique ID of the portfolio.
OwnerId String True No Globally unique ID of the Owner.
StartOn Date True No The day on which work for this project begins, or null if the project has no start date.
DueOn Date True No The day on which this project is due. This takes a date with format YYYY-MM-DD.
ProjectId String True Projects.Id No Globally unique ID of the Project. This column is a Pseudocolmn and its used for INSERT and UPDATE.

Return to Top

PortfolioMembership

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the portfoolio membership.
PortfolioId [KEY] String True Portfolios.Id No The portfolio the user is a member of.
PortfolioName String True No The name of the portfolio.
UserId [KEY] String True Users.Id No Globally unique ID of the user.
UserName String True No The users name.
ResourceType String True No The resource type of this resource.
WorkspaceId String True Workspaces.Id No Globally unique ID of the workspace. This column is a Pseudocolmn and its used in SELECT Query.

Return to Top

Portfolios

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the portfolio.
Name String False No Name of the portfolio.
Color String False No Color of the portfolio.
CreatedAt Datetime True No The time at which this portfolio was created.
CreatorId String True No Globally unique ID of the user created this portfolio.
CreatorName String True No The users name.
Members String False No Array of users who are members of this portfolio.
OwnerId String False Users.Id No Globally unique ID of the Owner. API users can only get a list of portfolios that they themselves own.
OwnerName String True No The Owners Name.
ResourceType String True No The base type of this resource.
WorkspaceId String False Workspaces.Id No The workspace or organization that the portfolio belongs to.
WorkspaceName String True No Name of the workspace.
ItemURL String True No A url that points directly to the object within Asana.
CurrentStatusUpdateId String True No Globally unique identifier of the resource, as a string.
CurrentStatusUpdateResourceType String True No The base type of this resource.
CurrentStatusUpdateTitle String True No The title of the status update.
CurrentStatusUpdateResourceSubtype String True No 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.
StartOn Date True No The day on which work for this portfolio begins, or null if the portfolio has no start date. This takes a date with YYYY-MM-DD format. Note: due_on must be present in the request when setting or unsetting the start_on parameter. Additionally, start_on and due_on cannot be the same date.
Public Boolean False No True if the portfolio is public to its workspace members.
ProjectTemplates String True No Array of project templates that are in the portfolio

Return to Top

ProjectFollowers

Name Type ReadOnly References FilterOnly Description
ProjectId String True Projects.Id No Globally unique ID of the Project.
UserId String True Users.Id No Globally unique ID of the user.
UserName String True No The user`s name.
ResourceType String True No The resource type of this resource.
WorkspaceId String True Workspaces.Id No The workspace this Project is associated with.

Return to Top

ProjectMembership

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the project membership.
ProjectId [KEY] String False Projects.Id No The project the user is a member of.
WriteAccess String True No Whether the user has full access to the project or has comment-only access.
UserId [KEY] String False Users.Id No The user in the membership.
ResourceType String True No The resource type of this resource.
MemberResourceType String True No The resource type of the member (team or user).
ResourceSubtype String True No Type of the membership.

Return to Top

Projects

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the project.
Name String False No 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.
Color String False No Color of the project. Must be either null or one of: dark-pink, dark-green, dark-blue, dark-red, dark-teal, dark-brown, dark-orange, dark-purple, dark-warm-gray, light-pink, light-green, light-blue, light-red, light-teal, light-yellow, light-orange, light-purple, light-warm-gray.
CreatedAt Datetime True No The time at which this project was created.
ModifiedAt Datetime True No The time at which this project was last modified.
StartOn Date False No The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format. Note: due_on must be present in the request when setting or unsetting the start_on parameter.
DueOn Date False No The day on which this project is due. This takes a date with format YYYY-MM-DD.
DefaultView String False No The default view of a project.
Followers String False No Followers are a subset of members who receive all notifications for a project.
Archived Boolean False No True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.
UserId String False Users.Id No The current owner of the project.
TeamId String False Teams.Id No The team that this project is shared with. This field only exists for projects in organizations.
WorkspaceId String True Workspaces.Id No The workspace or organization this project is associated with. Once created, projects cannot be moved to a different workspace. This attribute can only be specified at creation time.
Public Boolean False No True if the project is public to the organization. If false, do not share this project with other users in this organization without explicitly checking to see if they have access. For new integrations, please refer to PrivacySetting column.
Notes String False No More detailed, free-form textual information associated with the project.
HTMLNotes String False No The notes of the project with formatting as HTML.
IsTemplate Boolean False No Determines if the project is a template.
Layout String True No The layout (board or list view) of a project.
Members String True No Array of users who are members of this project.
SectionMigrationStatus String True No The section migration status of this project.
PrivacySetting String False No The privacy setting of the project.
TaskId String True Tasks.Id No Globally unique ID of the Task.
ItemURL String True No A url that points directly to the object within Asana.
CurrentStatusUpdateId String True No Globally unique identifier of the resource, as a string.
CurrentStatusUpdateResourceType String True No The base type of this resource.
CurrentStatusUpdateTitle String False No The title of the status update.
CurrentStatusUpdateResourceSubtype String True No 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.
ResourceType String True No The base type of this resource.
DefaultAccessLevel String False No The default access for users or teams who join or are added as members to the project.
MinimumAccessLevelForCustomization String False No The minimum access level needed for project members to modify this project's workflow and appearance.
MinimumAccessLevelForSharing String False No The minimum access level needed for project members to share the project and manage project memberships.
Completed Boolean True No True if the project is currently marked complete, false if not.
CompletedAt Datetime True No The time at which this project was completed, or null if the project is not completed.
CompletedById String True No Globally unique identifier of the resource, as a string.
CompletedByResourceType String True No The base type of this resource.
CompletedByName String True No Read-only except when same user as requester. The user�s name.
Icon String True No The icon for a project.
ProjectBriefId String True No The project brief associated with this project.
ProjectBriefResourceType String True No The project brief associated with this project.
CreatedFromTemplateId String True No Id of the project template from which this project was created. If the project was not created from a template, this field will be null.
CreatedFromTemplateResourceType String True No Resource type of the project template from which this project was created. If the project was not created from a template, this field will be null.
CreatedFromTemplateName String True No Name of the project template from which this project was created. If the project was not created from a template, this field will be null.

Return to Top

ProjectStatuses

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the project status update.
Color String True No The color associated with the status update.
Title String True No The title of the project status update.
Text String True No The text content of the status update.
CreatedAt Datetime True No The time at which the status update was created.
CreatedBy String True Users.Id No The creator of the status update.
ProjectId String True Projects.Id No Globally unique ID of the project.
ResourceType String True No The resource type of this resource. The value for this resource is always project_status.
HTMLText String True No The notes of the project with formatting as HTML.

Return to Top

ProjectTemplates

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique identifier of the resource, as a string.
Color String True No Color of the project template.
Description String True No Free-form textual information associated with the project template.
Html_description String True No The description of the project template with formatting as HTML.
Name String True No Name of the project template.
OwnerId String True Users.Id No A user object. Globally unique identifier of the resource, as a string.
OwnerName String True No A user object. The base type of this resource.
OwnerResourceType String True No A user object. Read-only except when same user as requester. The name of the User.
IsPublic Boolean True No True if the project template is public to its team.
RequestedDates String True No Array of date variables in this project template. Calendar dates must be provided for these variables when instantiating a project.
ResourceType String True No The base type of this resource.
TeamId String True Teams.Id No A team is used to group related projects and people together within an organization. Globally unique identifier of the resource, as a string.
TeamName String True No A team is used to group related projects and people together within an organization. The name of the team.
TeamResourceType String True No A team is used to group related projects and people together within an organization. The base type of this resource.
RequestedRoles String True No Array of template roles in this project template. User Ids can be provided for these variables when instantiating a project to assign template tasks to the user.
WorkspaceId String False Yes The workspace Id to filter results on.

Return to Top

Sections

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the section.
Name String False No The name of the section.
CreatedAt Datetime True No The time at which the section was created.
ResourceType String True No The resource type of this resource.
ProjectId String False Projects.Id No The section under the project.

Return to Top

StatusUpdates

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique identifier of the resource, as a string.
AuthorId String True No A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks. Globally unique identifier of the resource.
AuthorName String True No A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks. The user's name.
AuthorResourceType String True No A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks. The base type of this resource.
CreatedAt Datetime True No The time at which this resource was created.
CreatedById String True No A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks. Globally unique identifier of the resource.
CreatedByName String True No A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks. The user's name.
CreatedByResourceType String True No A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks. The base type of this resource.
Liked Boolean True No True if the status is liked by the authorized user, false if not.
Likes String True No Array of likes for users who have liked this status.
ModifiedAt Datetime True No The time at which this project status was last modified.
NumLikes Integer True No The number of users who have liked this status.
ParentId String False No Id of parent of the status update.
ParentName String True No Name of parent of the status update.
ParentResourceType String True No Resource type of parent of the status update.
ResourceSubtype String True No The subtype of this resource.
ResourceType String True No The base type of this resource.
StatusType String False No The type associated with the status update.
Text String False No The text content of the status update.
HTMLText String False No The text content of the status update with formatting as HTML.
Title String False No The title of the status update.

Return to Top

Stories

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the story.
Text String False No Formatted text for the story or comment.
CreatedAt Datetime True No The time at which this story was created.
creatorId String True Users.Id No The user who created the story.
creatorName String False Users.Name No The user who created the story.
Source String True No The component of the Asana product the user used to create the story.
TaskId String False Tasks.Id No The story under the task.
Liked Boolean True No True if the story is liked by the authorized user, false if not.
IsPinned Boolean False No This field is only present on comment and attachment stories.
IsEdited Boolean True No Whether the text of the story has been edited after creation.
ResourceType String True No The resource type of this resource.
ResourceSubType String True No The type of story. This provides fine-grained information about what triggered the story creation.
HtmlText String True No HTML formatted text for a comment.
DuplicateTaskOf String True Tasks.Id No The task is the basic object around which many operations in Asana are centered.
DependencyTaskId String True Tasks.Id No The task is the basic object around which many operations in Asana are centered.
NumberofLikes Integer True No The number of users who have liked this story.
Likes String True No Array of likes for users who have liked this story.
StickerName String False No The name of the sticker in this story. null if there is no sticker.
Type String True No Story type (comment or system)
Previews String True No A collection of previews to be displayed in the story. This property only exists for comment stories.
OldName String True No OldName
NewName String True No NewName
OldDatesStartOn Date True No 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.
OldDatesDueAt Datetime True No The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with due_on.
OldDatesDueOn Date True No The localized day on which this goal is due. This takes a date with format YYYY-MM-DD.
NewDatesStartOn Date True No 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.
NewDatesDueAt Datetime True No The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with due_on.
NewDatesDueOn Date True No The localized day on which this goal is due. This takes a date with format YYYY-MM-DD.
OldResourceSubtype String True No OldResourceSubtype
NewResourceSubtype String True No NewResourceSubtype
StoryId String True No Globally unique identifier of the resource, as a string.
StoryResourceType String True No The base type of this resource.
StoryCreatedAt Datetime True No The time at which this resource was created.
StoryCreatedById String True No Globally unique identifier of the resource, as a string.
StoryCreatedByResourceType String True No The base type of this resource.
StoryCreatedByName String True No Read-only except when same user as requester. The user�s name.
StoryResourceSubtype String True No 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.
StoryText String True No Human-readable text for the story or comment. This will not include the name of the creator. This is not guaranteed to be stable for a given type of story. For example, text for a reassignment may not always say �assigned to �� as the text for a story can both be edited and change based on the language settings of the user making the request. Use the resource_subtype property to discover the action that created the story.
AssigneeId String True No Globally unique identifier of the resource, as a string.
AssigneeResourceType String True No The base type of this resource.
AssigneeName String True No Read-only except when same user as requester. The user�s name.
FollowerId String True No Globally unique identifier of the resource, as a string.
FollowerResourceType String True No The base type of this resource.
FollowerName String True No Read-only except when same user as requester. The user�s name.
OldSectionId String True No Globally unique identifier of the resource, as a string.
OldSectionResourceType String True No The base type of this resource.
OldSectionName String True No Read-only except when same user as requester. The user�s name.
NewSectionId String True No Globally unique identifier of the resource, as a string.
NewSectionResourceType String True No The base type of this resource.
NewSectionName String True No Read-only except when same user as requester. The user�s name.
StoryTaskId String True No Globally unique identifier of the resource, as a string.
StoryTaskResourceType String True No The base type of this resource.
StoryTaskName String True No The name of the task.
TaskResourceSubtype String True No 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.
TaskCreatedById String True No Globally unique identifier of the resource.
TaskCreatedByResourceType String True No The type of resource.
ProjectId String True No Globally unique identifier of the resource, as a string.
ProjectResourceType String True No The base type of this resource.
ProjectName String True No 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.
TagId String True No Globally unique identifier of the resource, as a string.
TagResourceType String True No The base type of this resource.
TagName String True No Name of the tag. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
CustomField String True No CustomField
OldTextValue String True No OldTextValue
NewTextValue String True No NewTextValue
OldNumberValue Integer True No OldNumberValue
NewNumberValue Integer True No NewNumberValue
OldEnumValue String True No OldEnumValue
NewEnumValue String True No NewEnumValue
OldDateValue String True No OldDateValue
NewDateValue String True No NewDateValue
OldPeopleValue String True No OldPeopleValue
NewPeopleValue String True No NewPeopleValue
OldMultiEnumValues String True No OldMultiEnumValues
NewMultiEnumValues String True No NewMultiEnumValues
NewApprovalStatus String True No The new value of approval status.
OldApprovalStatus String True No The old value of approval status.
DuplicateOf String True No DuplicateOf

Return to Top

SubTasks

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the Subtask.
ParentTaskId String True Tasks.Id No Globally unique ID of the task.
Name String False No Name of the Subtask.
Assignee String False Users.Id No User to which this subtask is assigned.
AssigneeStatus String False No Scheduling status of this subtask for the user it is assigned to.
CreatedAt Datetime True No The time at which this subtask was created.
ModifiedAt Datetime True No The time at which this subtask was last modified.
startOn Date False No The day on which work begins for the task , or null if the task has no start date. This takes a date with YYYY-MM-DD format.
DueAt Datetime False No Date and time on which this subtask is due, or null if the subtask has no due time.
DueOn Date False No Date on which this task is due, or null if the task has no due date. This takes a date with YYYY-MM-DD format.
Completed Boolean False No True if the subtask is currently marked complete, false if not.
CompletedAt Datetime True No The time at which this subtask was completed, or null if the subtask is incomplete.
completed_by String True Users.Id No The user who completed this task.
ProjectId String False Projects.Id No Globally unique ID of the Project.
WorkspaceId String False Workspaces.Id No Globally unique ID of the Workspace.
Notes String False No More detailed, free-form textual information associated with the subtask.
ApprovalStatus String False No Reflects the approval status of this task.
ResourceSubType String False No 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.
HtmlNotes String False No The notes of the text with formatting as HTML.
Dependencies String True No Array of resources referencing tasks that this task depends on.
Memberships String True No Array of projects this task is associated with and the section it is in.
Dependents String True No Array of resources referencing tasks that depend on this task.
Liked Boolean False No True if the task is liked by the authorized user, false if not.
NumberofLikes Integer True No The number of users who have liked this Task.
LikedBy String True No Array of likes for users who have liked this task.
ResourceType String True No The base type of this resource.
IsRenderedAsSeparator Boolean True No In some contexts tasks can be rendered as a visual separator.
Followers String False No Array of users following this task.
Tags String False No Array of tags associated with this task.
CreatedById String True No Globally unique identifier of the resource.
CreatedByResourceType String True No The type of resource.
NumSubTasks Integer True No NumSubTasks.
StartAt Datetime True No StartAt.
ActualTimeMinutes Integer True No ActualTimeMinutes.
AssigneeSection String True No AssigneeSection.

Return to Top

Tags

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the tag.
Name String True No Name of the tag.
CreatedAt Datetime True No The time at which this tag was created.
Color String True No Color of the tag.
Notes String False No Notes of the tag.
Followers String False No Followers for the tag.
WorkspaceId String True Workspaces.Id No The workspace or organization this tag is associated with.
ResourceType String True No The base type of this resource.
TaskId String True Tasks.Id No The task this tag is mapped with.

Return to Top

TaskDependencies

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the task.
Name String False No Name of the task.
Assignee String False Users.Id No User to which this task is assigned.
AssigneeStatus String False No Scheduling status of this task for the user it is assigned to.
CreatedAt Datetime True No The time at which this task was created.
ModifiedAt Datetime True No The time at which this task was last modified.
startOn Date False No Date and time on which this task is due, or null if the task has no due time.
DueAt Datetime False No Date and time on which this task is due, or null if the task has no due time.
DueOn Date False No Date on which this task is due, or null if the task has no due date. This takes a date with YYYY-MM-DD format.
Completed Boolean False No True if the task is currently marked complete, false if not.
CompletedAt Datetime True No The time at which this task was completed, or null if the task is incomplete.
CompletedBy String True Users.Id No The user who completed this task.
Projects String False No Projects of this task is associated with.
WorkspaceId String False Workspaces.Id No Globally unique ID of the Workspace.
Notes String False No More detailed, free-form textual information associated with the task.
NumberofSubTasks Integer True No The number of subtasks on this task.
ApprovalStatus String False No Reflects the approval status of this task.
ResourceSubType String False No 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.
HtmlNotes String False No The notes of the text with formatting as HTML.
Memberships String True No Array of projects this task is associated with and the section it is in.
Dependencies String True No Array of resources referencing tasks that this task depends on.
Dependents String True No Array of resources referencing tasks that depend on this task.
Liked Boolean True No True if the task is liked by the authorized user, false if not.
NumberofLikes Integer True No The number of users who have liked this Task.
LikedBy String True No Array of likes for users who have liked this task.
ResourceType String True No The base type of this resource.
IsRenderedAsSeparator Boolean True No In some contexts tasks can be rendered as a visual separator.
Followers String False No Array of users following this task.
Tags String False No Array of tags associated with this task.
ActualTimeMinutes Double True No This value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value. Note: The time tracking feature is only available on the Asana Advanced or a higher subscription.
Parent String True No The parent of this task, or null if this is not a subtask.
ItemURL String True No A URL that points directly to the object within Asana.
External String False No The external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with OAuth to access or modify this data.
AssigneeResourceType String True No The base type of the Assignee resource.
AssigneeName String True No The Assignee user's name.
AssigneeSection String False No The assignee section is a subdivision of a project that groups tasks together in the assignee's 'My Tasks' list. The assignee_section property will be returned in the response only if the request was sent by the user who is the assignee of the task.
AssigneeSectionResourceType String True No The base type of the AssigneeSection resource.
AssigneeSectionName String True No The name of the The name of the section.
StartAt Datetime False No Date and time on which work begins for the task, or null if the task has no start time. It should not be used together with startOn.
CompletedByResourceType String True No The base type of the CompletedBy resource.
CompletedByName String True No The CompletedBy user's name.
WorkspaceResourceType String True No The base type of the Workspace resource.
WorkspaceName String True No The name of the workspace.
CreatedById String True No Globally unique identifier of the resource.
CreatedByResourceType String True No The type of resource.
TaskId [KEY] String True Tasks.Id No The task to operate on.

Return to Top

TaskDependents

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the task.
Name String True No Name of the task.
Assignee String True Users.Id No User to which this task is assigned.
AssigneeStatus String True No Scheduling status of this task for the user it is assigned to.
CreatedAt Datetime True No The time at which this task was created.
ModifiedAt Datetime True No The time at which this task was last modified.
StartOn Date True No Date and time on which this task is due, or null if the task has no due time.
DueAt Datetime True No Date and time on which this task is due, or null if the task has no due time.
DueOn Date True No Date on which this task is due, or null if the task has no due date. This takes a date with YYYY-MM-DD format.
Completed Boolean True No True if the task is currently marked complete, false if not.
CompletedAt Datetime True No The time at which this task was completed, or null if the task is incomplete.
CompletedBy String True Users.Id No The user who completed this task.
Projects String True No Projects of this task is associated with.
WorkspaceId String True Workspaces.Id No Globally unique ID of the Workspace.
Notes String True No More detailed, free-form textual information associated with the task.
NumberofSubTasks Integer True No The number of subtasks on this task.
ApprovalStatus String True No Reflects the approval status of this task.
ResourceSubType String True No 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.
HtmlNotes String True No The notes of the text with formatting as HTML.
Memberships String True No Array of projects this task is associated with and the section it is in.
Dependencies String True No Array of resources referencing tasks that this task depends on.
Dependents String True No Array of resources referencing tasks that depend on this task.
Liked Boolean True No True if the task is liked by the authorized user, false if not.
NumberofLikes Integer True No The number of users who have liked this Task.
LikedBy String True No Array of likes for users who have liked this task.
ResourceType String True No The base type of this resource.
IsRenderedAsSeparator Boolean True No In some contexts tasks can be rendered as a visual separator.
Followers String True No Array of users following this task.
Tags String True No Array of tags associated with this task.
ActualTimeMinutes Double True No This value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value. Note: The time tracking feature is only available on the Asana Advanced or a higher subscription.
Parent String True No The parent of this task, or null if this is not a subtask.
ItemURL String True No A URL that points directly to the object within Asana.
External String True No The external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with OAuth to access or modify this data.
AssigneeResourceType String True No The base type of the Assignee resource.
AssigneeName String True No The Assignee user's name.
AssigneeSection String True No The assignee section is a subdivision of a project that groups tasks together in the assignee's 'My Tasks' list. The assignee_section property will be returned in the response only if the request was sent by the user who is the assignee of the task.
AssigneeSectionResourceType String True No The base type of the AssigneeSection resource.
AssigneeSectionName String True No The name of the The name of the section.
StartAt Datetime True No Date and time on which work begins for the task, or null if the task has no start time. It should not be used together with startOn.
CompletedByResourceType String True No The base type of the CompletedBy resource.
CompletedByName String True No The CompletedBy user's name.
WorkspaceResourceType String True No The base type of the Workspace resource.
WorkspaceName String True No The name of the workspace.
CreatedById String True No Globally unique identifier of the resource.
CreatedByResourceType String True No The type of resource.
TaskId [KEY] String True Tasks.Id No The task to operate on.

Return to Top

Tasks

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the task.
Name String False No Name of the task.
Assignee String False Users.Id No User to which this task is assigned.
AssigneeStatus String False No Scheduling status of this task for the user it is assigned to.
CreatedAt Datetime True No The time at which this task was created.
ModifiedAt Datetime True No The time at which this task was last modified.
startOn Date False No Date and time on which this task is due, or null if the task has no due time.
DueAt Datetime False No Date and time on which this task is due, or null if the task has no due time.
DueOn Date False No Date on which this task is due, or null if the task has no due date. This takes a date with YYYY-MM-DD format.
Completed Boolean False No True if the task is currently marked complete, false if not.
CompletedAt Datetime True No The time at which this task was completed, or null if the task is incomplete.
CompletedBy String True Users.Id No The user who completed this task.
ProjectId String False Projects.Id No Projectid of this task is associated with.
Projects String False No Projects of this task is associated with.
WorkspaceId String False Workspaces.Id No Globally unique ID of the Workspace.
Notes String False No More detailed, free-form textual information associated with the task.
NumberofSubTasks Integer True No The number of subtasks on this task.
ApprovalStatus String False No Reflects the approval status of this task.
ResourceSubType String False No 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.
HtmlNotes String False No The notes of the text with formatting as HTML.
Memberships String True No Array of projects this task is associated with and the section it is in.
Dependencies String True No Array of resources referencing tasks that this task depends on.
Dependents String True No Array of resources referencing tasks that depend on this task.
Liked Boolean True No True if the task is liked by the authorized user, false if not.
NumberofLikes Integer True No The number of users who have liked this Task.
LikedBy String True No Array of likes for users who have liked this task.
ResourceType String True No The base type of this resource.
IsRenderedAsSeparator Boolean True No In some contexts tasks can be rendered as a visual separator.
Followers String False No Array of users following this task.
Tags String False No Array of tags associated with this task.
ActualTimeMinutes Double True No This value represents the sum of all the Time Tracking entries in the Actual Time field on a given Task. It is represented as a nullable long value. Note: The time tracking feature is only available on the Asana Advanced or a higher subscription.
Parent String True No The parent of this task, or null if this is not a subtask.
ItemURL String True No A URL that points directly to the object within Asana.
External String False No The external field allows you to store app-specific metadata on tasks, including a gid that can be used to retrieve tasks and a data blob that can store app-specific character strings. Note that you will need to authenticate with OAuth to access or modify this data.
AssigneeResourceType String True No The base type of the Assignee resource.
AssigneeName String True No The Assignee user's name.
AssigneeSection String False No The assignee section is a subdivision of a project that groups tasks together in the assignee's 'My Tasks' list. The assignee_section property will be returned in the response only if the request was sent by the user who is the assignee of the task.
AssigneeSectionResourceType String True No The base type of the AssigneeSection resource.
AssigneeSectionName String True No The name of the The name of the section.
StartAt Datetime False No Date and time on which work begins for the task, or null if the task has no start time. It should not be used together with startOn.
CompletedByResourceType String True No The base type of the CompletedBy resource.
CompletedByName String True No The CompletedBy user's name.
WorkspaceResourceType String True No The base type of the Workspace resource.
WorkspaceName String True No The name of the workspace.
CreatedById String True No Globally unique identifier of the resource.
CreatedByResourceType String True No The type of resource.
SectionId String True Sections.Id No PseudoColumn: Globally unique ID of the section.
UserTaskListId String True workspacemembership.UserTaskListId No PseudoColumn: A user task list represents the tasks assigned to a particular user.
TagId String True Tags.Id No PseudoColumn: Globally unique ID of the tag.

Return to Top

TaskStatuses

Name Type ReadOnly References FilterOnly Description
ProjectId String True Projects.Id No Globally unique ID of the project.
NumberofTasks Integer True No The number of tasks in a project.
CompletedTasks Integer True No The number of completed tasks in a project.
IncompleteTasks Integer True No The number of incomplete tasks in a project.
NumberofMilestones Integer True No The number of milestones in a project.
CompletedMilestones Integer True No The number of completed milestones in a project.
InCompleteMilestones Integer True No The number of incomplete milestones in a project.

Return to Top

TaskTemplates

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the user.
ResourceType String True No The base type of this resource.
Name String True No Name of the task template.
ProjectId String True Projects.Id No Globally unique identifier of the resource, as a string.
ProjectName String True No 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.
TemplateName String True No Globally unique identifier of the resource, as a string.
TemplateTaskResourceSubtype String True No The subtype of the task that will be created from this template.
TemplateDescription String True No Description of the task that will be created from this template.
TemplateHTMLDescription String True No HTML description of the task that will be created from this template.
TemplateMemberships String True No Array of projects that the task created from this template will be added to.
TemplateRelativeStartOn Integer True No The number of days after the task has been instantiated on which that the task will start.
TemplateRelativeDueOn Integer True No The number of days after the task has been instantiated on which that the task will be due.
TemplateDueTime String True No The time of day that the task will be due.
TemplateDependencies String True No Array of task templates that the task created from this template will depend on.
TemplateDependents String True No Array of task templates that will depend on the task created from this template.
TemplateFollowers String True No Array of users that will be added as followers to the task created from this template.
TemplateAttachments String True No Array of attachments that will be added to the task created from this template.
TemplateSubtasks String True No Array of subtasks that will be added to the task created from this template.
CreatedById String True No Globally unique identifier of the resource, as a string.
CreatedByName String True No Read-only except when same user as requester. The user�s name.
CreatedAt Datetime True No The time at which this task template was created.

Return to Top

TeamMembership

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique identifier of the resource, as a string.
userId [KEY] String True Users.Id No Globally unique ID of the user.
userName String True No The users name.
TeamId [KEY] String True Teams.Id No Globally unique ID of the team.
TeamName String True No The name of the team.
IsGuest Boolean True No Describes if the user is a guest in the team.
ResourceType String True No The base type of this resource.
IsLimitedAccess Boolean True No Describes if the user has limited access to the team.
IsAdmin Boolean True No Describes if the user is a team admin.
WorkspaceId String True Workspaces.Id No Globally unique ID of the workspace.

Return to Top

Teams

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the team.
Name String False No The name of the team.
Description String False No The description of the team.
WorkspaceId String True Workspaces.Id No The workspace or organization this team is associated with.
HTMLDescrption String False No The description of the team with formatting as HTML.
ResourceType String True No The resource type of this resource.
ItemURL String True No A url that points directly to the object within Asana.
Visibility String False No The visibility of the team to users in the same organization.
TeamContentManagementAccessLevel String False No Controls who can create and share content with the team.
EditTeamNameOrDescriptionAccessLevel String True No Controls who can edit team name and description.
EditTeamVisibilityOrTrashTeamAccessLevel String True No Controls who can edit team visibility and trash teams.
MemberInviteManagementAccessLevel String True No Controls who can accept or deny member invites for a given team.
GuestInviteManagementAccessLevel String True No Controls who can accept or deny guest invites for a given team.
JoinRequestManagementAccessLevel String True No Controls who can accept or deny join team requests for a Membership by Request team.
TeamMemberRemovalAccessLevel String True No Controls who can remove team members.
OrganizationResourceType String True No The base type of this resource.
OrganizationName String True No The name of the workspace.
UserId String True Users.Id No Globally unique ID of the user.

Return to Top

TimePeriods

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the user.
ResourceType String True No The base type of this resource.
EndOn String True No The localized end date of the time period in YYYY-MM-DD format.
StartOn String True No The localized start date of the time period in YYYY-MM-DD format.
Period String True No The cadence and index of the time period. The value is one of: FY, H1, H2, Q1, Q2, Q3, or Q4.
DisplayName String True No A string representing the cadence code and the fiscal year.
ParentId String True No Globally unique ID of the user.
ParentResourceType String True No The base type of this resource.
ParentEndOn String True No The localized end date of the time period in YYYY-MM-DD format.
ParentStartOn String True No The localized start date of the time period in YYYY-MM-DD format.
ParentPeriod String True No The cadence and index of the time period. The value is one of: FY, H1, H2, Q1, Q2, Q3, or Q4.
ParentDisplayName String True No A string representing the cadence code and the fiscal year.
WorkspaceId String True Workspaces.Id No Globally unique ID of the workspace.

Return to Top

TimeTrackingEntries

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the team.
ResourceType String True No The base type of this resource.
CreatedBy String True No A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
CreatedByResourceType String True No The base type of the CreatedBy user resource.
CreatedByName String True No The user's name.
DurationMinutes Integer False No Time in minutes tracked by the entry.
EnteredOn Date False No The day that this entry is logged on.
CreatedAt Datetime True No The time at which this resource was created.
TaskId String False No The associated Task's object Id. The task is the basic object around which many operations in Asana are centered.
TaskResourceType String True No The base type of the Task resource.
TaskName String True No The name of the task.
TaskResourceSubtype String True No The subtype of the Task resource.

Return to Top

Users

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the user.
Name String True No The user`s name.
Email String True No The user`s email address.
ResourceType String True No The resource type of this resource.
WorkspaceId String True Workspaces.Id No The User access in workspaces.
TeamId String True Teams.Id No Globally unique ID of the team.

Return to Top

UserTaskList

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True workspacemembership.UserTaskListId No Globally unique ID of the user task list.
Name String True No The name of the user task list.
UserId String True Users.Id No The owner of the user task list.
workspaceId String True Workspaces.Id No The workspace in which the user task list is located.
ResourceType String True No The resource type of this resource.

Return to Top

WorkspaceMembership

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the membership.
userId [KEY] String True Users.Id No Globally unique ID of the user.
userName String True No The user`s name.
WorkspaceId [KEY] String True Workspaces.Id No Globally unique ID of the workspace.
WorkspaceName String True No The Workspace name.
IsActive Boolean True No Reflects if this user still a member of the workspace.
IsAdmin Boolean True No Reflects if this user is an admin of the workspace.
IsGuest Boolean True No Reflects if this user is a guest of the workspace.
UserTaskListId String True UserTaskList.Id No A user task list represents the tasks assigned to a particular user.
ResourceType String True No The base type of this resource.
VacationStartDate String True No The day on which the user's vacation in this workspace starts.
VacationEndDate String True No The day on which the user's vacation in this workspace ends.
CreatedAt Datetime True No The time at which this resource was created.

Return to Top

Workspaces

Name Type ReadOnly References FilterOnly Description
Id [KEY] String True No Globally unique ID of the workspace.
Name String False No The name of the workspace.
ResourceType String True No The resource type of this resource.
IsOrganization Boolean True No Whether the workspace is an organization.
EmailDomains String True No Whether the workspace is an organization.
ItemURL String True No A url that points directly to the object within Asana.
UserId String True Users.Id No Globally unique ID of the user.

Return to Top