Jobs

Jobs represent processes that handle asynchronous work. A job created when an endpoint requests an action that will be handled asynchronously, such as project or task duplication.

Only the creator of the duplication process can access the duplication status of the new object.

📘

Intermittent states

With any work that is handled asynchronously (e.g., project instantiation from a template, duplicating a task or project, etc.), the intermittent states of newly-created objects may not be consistent. That is, object properties may return different values each time when polled until the job status has returned a succeeded value.


JobCompact

A Compact object reflects the default fields returned after a successful API request. See input/output options to include more fields in the response.

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
new_projectobjectA project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.
new_project.gidstringGlobally unique identifier of the resource, as a string.
new_project.resource_typestringThe base type of this resource.
new_project.namestringName 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.
new_project_templateobjectA project template is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.
new_project_template.gidstringGlobally unique identifier of the resource, as a string.
new_project_template.resource_typestringThe base type of this resource.
new_project_template.namestringName of the project template.
new_taskobject¦nullThe task is the basic object around which many operations in Asana are centered.
new_task.gidstringGlobally unique identifier of the resource, as a string.
new_task.resource_typestringThe base type of this resource.
new_task.namestringThe name of the task.
new_task.resource_subtypestringThe 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_subtype milestone represents a single moment in time. This means tasks with this subtype cannot have a start_date.
resource_subtypestringThe 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.
statusstringThe current status of this job. The value is one of: not_started, in_progress, succeeded, or failed.
{
  "gid": "12345",
  "resource_type": "job",
  "new_project": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  },
  "new_project_template": {
    "gid": "12345",
    "resource_type": "project_template",
    "name": "Packing list"
  },
  "new_task": {
    "gid": "12345",
    "resource_type": "task",
    "name": "Bug Task",
    "resource_subtype": "default_task"
  },
  "resource_subtype": "duplicate_task",
  "status": "in_progress"
}

Job

A job is an object representing a process that handles asynchronous work.

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
new_projectobjectA project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.
new_project.gidstringGlobally unique identifier of the resource, as a string.
new_project.resource_typestringThe base type of this resource.
new_project.namestringName 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.
new_project_templateobjectA project template is an object that allows new projects to be created with a predefined setup, which may include tasks, sections, Rules, etc. It simplifies the process of running a workflow that involves a similar set of work every time.
new_project_template.gidstringGlobally unique identifier of the resource, as a string.
new_project_template.resource_typestringThe base type of this resource.
new_project_template.namestringName of the project template.
new_taskobject¦nullThe task is the basic object around which many operations in Asana are centered.
new_task.gidstringGlobally unique identifier of the resource, as a string.
new_task.resource_typestringThe base type of this resource.
new_task.namestringThe name of the task.
new_task.resource_subtypestringThe 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_subtype milestone represent a single moment in time. This means tasks with this subtype cannot have a start_date.
resource_subtypestringThe 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.
statusstringThe current status of this job. The value is one of: not_started, in_progress, succeeded, or failed.
{
  "gid": "12345",
  "resource_type": "job",
  "new_project": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  },
  "new_project_template": {
    "gid": "12345",
    "resource_type": "project_template",
    "name": "Packing list"
  },
  "new_task": {
    "gid": "12345",
    "resource_type": "task",
    "name": "Bug Task",
    "resource_subtype": "default_task"
  },
  "resource_subtype": "duplicate_task",
  "status": "in_progress"
}
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.