Task

Used to retrieve a list of tasks (or an individual one). Also used to search for tasks in a workspace, and retrieve subtasks of a given task. Endpoints: /api/1.0/tasks /api/1.0/tasks/{taskId} /api/1.0/tasks/{taskId}/subtasks /api/1.0/workspaces/{workspaceId}/tasks/search

🔗↗️

User

Used to retrieve a list of users (a user object represents an account in Asana that can be given access to various workspaces, projects, and tasks) Endpoints: /api/1.0/users

🔗↗️

ProjectCompact

Used to retrieve a list of projects for a given team Endpoints: /api/1.0/teams/{teamId}/projects

🔗↗️

Story

Used to retrieve a list of stories associated with a task. Endpoints: /api/1.0/tasks/{taskId}/stories

🔗↗️

WorkspaceCompact

Used to retrieve a list of workspaces (all projects and tasks have an associated workspace) Endpoints: /api/1.0/workspaces

🔗↗️

TeamCompact

Used to retrieve a list of teams for a given workspace Endpoints: /api/1.0/workspaces/{workspaceId}/teams

🔗↗️

actualTimeMinutes

Long

approvalStatus

String

assignee

User

The user to whom the task is assigned. Any PII data is pseudonymized.

assigneeSection

Resource

assigneeSection.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

assigneeSection.name

String

assigneeSection.resourceType

String

assigneeStatus

String

completed

Boolean

completedAt

Instant

completedBy

User

The user who completed the task. Any PII data is pseudonymized.

createdAt

Instant

createdBy

User

The user who created the task. Any PII data is pseudonymized.

createdBy.email

String

The user's email address Raw example: alice@acme.com Sanitized example:

{
	"scope":"email",
	"domain":"acme.com",
	"hash":"aT3usZghgyWmDoXRncq5qhmQJQMjY49xDJylpM4TyYI"
}

createdBy.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

createdBy.name

String

createdBy.resourceType

String

customFields[]

List of CustomField

customFields[].asanaCreatedField

String

customFields[].createdBy

User

Any PII data is pseudonymized.

customFields[].currencyCode

String

customFields[].customLabel

String

customFields[].customLabelPosition

String

customFields[].dateValue

CustomFieldDate

customFields[].dateValue.date

LocalDate

customFields[].dateValue.dateTime

String

customFields[].description

String

customFields[].displayValue

String

customFields[].enabled

Boolean

customFields[].enumOptions[]

List of EnumObject

customFields[].enumOptions[].enabled

Boolean

customFields[].enumOptions[].gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

customFields[].enumOptions[].name

String

customFields[].enumOptions[].resourceType

String

customFields[].enumValue

EnumObject

customFields[].enumValue.enabled

Boolean

customFields[].enumValue.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

customFields[].enumValue.name

String

customFields[].enumValue.resourceType

String

customFields[].format

String

customFields[].gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

customFields[].hasNotificationsEnabled

Boolean

customFields[].isGlobalToWorkspace

Boolean

customFields[].multiEnumValues[]

List of EnumObject

customFields[].name

String

customFields[].numberValue

String

customFields[].peopleValue[]

List of Resource

customFields[].precision

Integer

customFields[].resourceSubtype

String

customFields[].resourceType

String

customFields[].textValue

String

customFields[].type

String

dependencies[]

List of Resource

dependencies[].gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

dependencies[].name

String

dependencies[].resourceType

String

dependents[]

List of Resource

dueAt

Instant

dueOn

LocalDate

external

External

external.data

String

external.gid

String

followers[]

List of User

List of users following the task. Any PII data is pseudonymized.

gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

htmlNotes

String

is_rendered_as_separator

Boolean

liked

Boolean

likes[]

List of UserInteraction

User interactions of the task. Any PII data is pseudonymized.

likes[].gid

String

Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

likes[].user

User

Any PII data is pseudonymized.

memberships[]

List of Membership

memberships[].project

Resource

memberships[].project.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

memberships[].project.name

String

memberships[].project.resourceType

String

memberships[].section

Resource

memberships[].section.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

memberships[].section.name

String

memberships[].section.resourceType

String

modifiedAt

Instant

name

String

notes

String

numHearts

Integer

numLikes

Integer

numSubtasks

Integer

parent

Task

permalinkUrl

String

projects[]

List of ProjectCompact

projects[].gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

projects[].name

String

projects[].resourceType

String

resourceSubtype

String

resourceType

String

startAt

Instant

startOn

LocalDate

tags[]

List of TagCompact

tags[].gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

tags[].name

String

tags[].resourceType

String

workspace

WorkspaceCompact

workspace.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

workspace.name

String

workspace.resourceType

String

email

String

The user's email address Raw example: alice@acme.com Sanitized example:

{
	"scope":"email",
	"domain":"acme.com",
	"hash":"aT3usZghgyWmDoXRncq5qhmQJQMjY49xDJylpM4TyYI"
}

gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

name

String

resourceType

String

gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

name

String

resourceType

String

assignee

User

Any PII data is pseudonymized.

assignee.email

String

The user's email address Raw example: alice@acme.com Sanitized example:

{
	"scope":"email",
	"domain":"acme.com",
	"hash":"aT3usZghgyWmDoXRncq5qhmQJQMjY49xDJylpM4TyYI"
}

assignee.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

assignee.name

String

assignee.resourceType

String

createdAt

Instant

createdBy

User

Any PII data is pseudonymized.

customField

CustomField

customField.asanaCreatedField

String

customField.createdBy

User

Any PII data is pseudonymized.

customField.currencyCode

String

customField.customLabel

String

customField.customLabelPosition

String

customField.dateValue

CustomFieldDate

customField.dateValue.date

LocalDate

customField.dateValue.dateTime

String

customField.description

String

customField.displayValue

String

customField.enabled

Boolean

customField.enumOptions[]

List of EnumObject

customField.enumOptions[].enabled

Boolean

customField.enumOptions[].gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

customField.enumOptions[].name

String

customField.enumOptions[].resourceType

String

customField.enumValue

EnumObject

customField.enumValue.enabled

Boolean

customField.enumValue.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

customField.enumValue.name

String

customField.enumValue.resourceType

String

customField.format

String

customField.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

customField.hasNotificationsEnabled

Boolean

customField.isGlobalToWorkspace

Boolean

customField.multiEnumValues[]

List of EnumObject

customField.name

String

customField.numberValue

String

customField.peopleValue[]

List of Resource

customField.peopleValue[].gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

customField.peopleValue[].name

String

customField.peopleValue[].resourceType

String

customField.precision

Integer

customField.resourceSubtype

String

customField.resourceType

String

customField.textValue

String

customField.type

String

dependency

ResourceWithSubtype

dependency.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

dependency.name

String

dependency.resourceSubtype

String

dependency.resourceType

String

duplicateOf

ResourceWithSubtype

duplicateOf.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

duplicateOf.name

String

duplicateOf.resourceSubtype

String

duplicateOf.resourceType

String

duplicatedFrom

ResourceWithSubtype

duplicatedFrom.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

duplicatedFrom.name

String

duplicatedFrom.resourceSubtype

String

duplicatedFrom.resourceType

String

follower

User

Any PII data is pseudonymized.

gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

hearted

N/A

htmlText

String

html_text

N/A

isEditable

Boolean

isEdited

Boolean

isPinned

Boolean

liked

Boolean

likes[]

List of UserInteraction

Any PII data is pseudonymized.

likes[].gid

String

Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

likes[].user

User

Any PII data is pseudonymized.

name

String

newApprovalStatus

String

newDates

StoryDate

newDates.dueAt

Instant

newDates.dueOn

LocalDate

newDates.startOn

LocalDate

newEnumValue

EnumObject

newEnumValue.enabled

Boolean

newEnumValue.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

newEnumValue.name

String

newEnumValue.resourceType

String

newMultiEnumValues[]

List of EnumObject

newName

String

newNumberValue

String

newPeopleValue

Resource

newPeopleValue.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

newPeopleValue.name

String

newPeopleValue.resourceType

String

newResourceSubtype

String

newSection

Resource

newSection.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

newSection.name

String

newSection.resourceType

String

newTextValue

String

new_name

N/A

new_text_value

N/A

numHearts

Integer

numLikes

Integer

oldApprovalStatus

String

oldDates

StoryDate

oldDates.dueAt

Instant

oldDates.dueOn

LocalDate

oldDates.startOn

LocalDate

oldEnumValue

EnumObject

oldEnumValue.enabled

Boolean

oldEnumValue.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

oldEnumValue.name

String

oldEnumValue.resourceType

String

oldMultiEnumValues[]

List of EnumObject

oldName

String

oldNumberValue

String

oldPeopleValue

Resource

oldPeopleValue.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

oldPeopleValue.name

String

oldPeopleValue.resourceType

String

oldResourceSubtype

String

oldSection

Resource

oldSection.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

oldSection.name

String

oldSection.resourceType

String

oldTextValue

String

old_name

N/A

old_text_value

N/A

previews[]

List of Preview

previews[].fallBack

String

previews[].footer

String

previews[].gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

previews[].header

String

previews[].headerLink

String

previews[].htmlText

String

previews[].name

String

previews[].resourceType

String

previews[].text

String

previews[].title

String

previews[].titleLink

String

project

ProjectCompact

project.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

project.name

String

project.resourceType

String

resourceSubtype

String

resourceType

String

source

String

stickerName

String

story

StoryCompact

story.createdAt

Instant

story.createdBy

User

Any PII data is pseudonymized.

story.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

story.name

String

story.resourceSubtype

String

story.resourceType

String

story.text

String

tag

TagCompact

tag.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

tag.name

String

tag.resourceType

String

target

Task

target.actualTimeMinutes

Long

target.approvalStatus

String

target.assignee

User

The user to whom the task is assigned. Any PII data is pseudonymized.

target.assigneeSection

Resource

target.assigneeStatus

String

target.completed

Boolean

target.completedAt

Instant

target.completedBy

User

The user who completed the task. Any PII data is pseudonymized.

target.createdAt

Instant

target.createdBy

User

The user who created the task. Any PII data is pseudonymized.

target.customFields[]

List of CustomField

target.dependencies[]

List of Resource

target.dependents[]

List of Resource

target.dueAt

Instant

target.dueOn

LocalDate

target.external

External

target.external.data

String

target.external.gid

String

target.followers[]

List of User

List of users following the task. Any PII data is pseudonymized.

target.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

target.htmlNotes

String

target.is_rendered_as_separator

Boolean

target.liked

Boolean

target.likes[]

List of UserInteraction

User interactions of the task. Any PII data is pseudonymized.

target.memberships[]

List of Membership

target.memberships[].project

Resource

target.memberships[].section

Resource

target.modifiedAt

Instant

target.name

String

target.notes

String

target.numHearts

Integer

target.numLikes

Integer

target.numSubtasks

Integer

target.parent

Task

target.permalinkUrl

String

target.projects[]

List of ProjectCompact

target.resourceSubtype

String

target.resourceType

String

target.startAt

Instant

target.startOn

LocalDate

target.tags[]

List of TagCompact

target.workspace

WorkspaceCompact

target.workspace.gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

target.workspace.name

String

target.workspace.resourceType

String

task

Task

text

String

type

String

gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example:

p~SIoJOpeSgYF7YUP

name

String

resourceType

String

gid

String

Globally unique identifier of the resource Raw example: 4831887 Sanitized example: