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 asucceeded
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.
Property | Type | Description |
---|---|---|
gid | string | Globally unique identifier of the resource, as a string. |
resource_type | string | The base type of this resource. |
new_project | object | A 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 .gid | string | Globally unique identifier of the resource, as a string. |
new_project .resource_type | string | The base type of this resource. |
new_project .name | string | 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. |
new_project_template | object | A 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 .gid | string | Globally unique identifier of the resource, as a string. |
new_project_template .resource_type | string | The base type of this resource. |
new_project_template .name | string | Name of the project template. |
new_task | objectยฆnull | The task is the basic object around which many operations in Asana are centered. |
new_task .gid | string | Globally unique identifier of the resource, as a string. |
new_task .resource_type | string | The base type of this resource. |
new_task .name | string | The name of the task. |
new_task .resource_subtype | string | 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_subtype milestone represents a single moment in time. This means tasks with this subtype cannot have a start_date . |
resource_subtype | string | 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. |
status | string | The 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.
Property | Type | Description |
---|---|---|
gid | string | Globally unique identifier of the resource, as a string. |
resource_type | string | The base type of this resource. |
new_project | object | A 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 .gid | string | Globally unique identifier of the resource, as a string. |
new_project .resource_type | string | The base type of this resource. |
new_project .name | string | 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. |
new_project_template | object | A 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 .gid | string | Globally unique identifier of the resource, as a string. |
new_project_template .resource_type | string | The base type of this resource. |
new_project_template .name | string | Name of the project template. |
new_task | objectยฆnull | The task is the basic object around which many operations in Asana are centered. |
new_task .gid | string | Globally unique identifier of the resource, as a string. |
new_task .resource_type | string | The base type of this resource. |
new_task .name | string | The name of the task. |
new_task .resource_subtype | string | 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_subtype milestone represent a single moment in time. This means tasks with this subtype cannot have a start_date . |
resource_subtype | string | 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. |
status | string | The 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"
}