Sign in
Timesheet approval statuses

Update a timesheet approval status

<b>Required scope: </b><code>timesheet_approval_statuses:write</code>

Updates the approval status of a timesheet approval status. The update supports state transitions such as submitting, recalling submission, approving, and rejecting. Only the fields provided in the data block will be updated; any unspecified fields will remain unchanged. Invalid transitions will result in a 400 error.

put/timesheet_approval_statuses/{timesheet_approval_status_gid}

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/timesheet_approval_statuses/{timesheet_approval_status_gid}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token, scopes: timesheet_approval_statuses:write)

Query parameters

opt_fieldsstring[]

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.

Request body

Example request

{
  "data": {
    "approval_status": "submitted",
    "message": "Approved by manager"
  }
}

Response

Successfully updated the requested timesheet approval status.

Example response

{
  "data": {
    "gid": "12345",
    "resource_type": "timesheet_approval_status",
    "created_at": "2012-02-22T02:06:58.147Z",
    "user": {
      "gid": "12345",
      "resource_type": "user",
      "name": "Greg Sanchez"
    },
    "workspace": {
      "gid": "12345",
      "resource_type": "workspace",
      "name": "My Company Workspace"
    },
    "start_date": "2025-01-06",
    "end_date": "2025-01-12",
    "approval_status": "DRAFT"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.