Asana API
Getting access, Developing, Testing
Back to Asana
Get A Project Status
Deprecated: new integrations should prefer the /status_updates/{status_gid} route.
Returns the complete record for a single status update.
Input
type: object
properties:
parameters:
type: object
properties:
project_status_gid:
type: string
description: The project status update to get.
opt_pretty:
type: boolean
description: >-
Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this
means doing proper line breaking and indentation to make it readable.
This will take extra time and increase the response size so it is
advisable only to use this during debugging.
opt_fields:
type: array
items:
type: string
description: >-
Defines fields to return.
Some requests return *compact* representations of objects in order to
conserve resources and complete the request more efficiently. Other
times requests return more information than you may need. This option
allows you to list the exact set of fields that the API should be sure
to return for the objects. The field names should be provided as
paths, described below.
The id of included objects will always be returned, regardless of the
field options.
required:
- project_status_gid
title: Parameters
Output
type: object
properties:
data:
type: object
properties:
gid:
description: Globally unique identifier of the resource, as a string.
type: string
readOnly: true
example: '12345'
x-insert-after: false
resource_type:
description: The base type of this resource.
type: string
readOnly: true
example: task
x-insert-after: gid
title:
description: The title of the project status update.
type: string
example: Status Update - Jun 15
text:
description: The text content of the status update.
type: string
example: The project is moving forward according to plan...
html_text:
description: >-
[Opt In](/docs/inputoutput-options). The text content of the status
update with formatting as HTML.
type: string
example: >-
<body>The project <strong>is</strong> moving forward according to
plan...</body>
color:
description: The color associated with the status update.
type: string
enum:
- green
- yellow
- red
- blue
author:
type: object
properties:
gid:
description: Globally unique identifier of the resource, as a string.
type: string
readOnly: true
example: '12345'
x-insert-after: false
resource_type:
description: The base type of this resource.
type: string
readOnly: true
example: task
x-insert-after: gid
name:
type: string
description: '*Read-only except when same user as requester*. The user’s name.'
example: Greg Sanchez
created_at:
description: The time at which this resource was created.
type: string
format: date-time
readOnly: true
example: '2012-02-22T02:06:58.147Z'
created_by:
type: object
properties:
gid:
description: Globally unique identifier of the resource, as a string.
type: string
readOnly: true
example: '12345'
x-insert-after: false
resource_type:
description: The base type of this resource.
type: string
readOnly: true
example: task
x-insert-after: gid
name:
type: string
description: '*Read-only except when same user as requester*. The user’s name.'
example: Greg Sanchez
modified_at:
description: >-
The time at which this project status was last modified.
*Note: This does not currently reflect any changes in associations
such as comments that may have been added or removed from the project
status.*
type: string
format: date-time
readOnly: true
example: '2012-02-22T02:06:58.147Z'