← All integrations

Asana

Read + coarse write

GroundTruth reads your Asana tasks, links each to the GitHub work that implements it, and reports status honestly. Because Asana has no native workflow states, write-back is deliberately coarser than Jira, Linear, or Azure DevOps, and we tell you exactly what it does.

What "coarse write" means, plainly.

Asana tasks are complete or incomplete; there is no built-in "In Review" state to move a task into. GroundTruth can always flip completion, and it will set a Status enum custom field when your project has one. It will never invent a workflow state Asana does not model. If your team encodes status in board sections or a Status field, read is accurate; if it relies on ad-hoc columns, write-back is limited to completion.

What we read

  • Tasks in a project: name, notes, completion, assignee, parent, and last-modified.
  • Status, resolved in this order: an enum custom field named Status, then the task's section on a board, then the plain complete / incomplete flag.

What we write back

  • Done targets mark the task complete.
  • Other targets set the matching option on your Status enum field, if one exists, and keep the task incomplete.
  • With no Status field, non-done targets fall back to leaving the task incomplete; we do not fabricate a state.

Every write is recorded in the audit chain and is revertible, the same as our other trackers.

Acceptance-criteria gate

A merged pull request will not mark a task complete while its acceptance criteria, read from the task notes, are unmet. The task stays incomplete and is flagged for a human.

Setup

  1. Connect with an Asana personal access token, or via OAuth.
  2. Set the project to sync. For richer write-back, add a "Status" enum custom field to the project.
  3. We backfill the project's tasks, then keep them current from webhooks.

Status mapping

Asana signalGroundTruth category
Task marked completedone
"Status" enum field: Done / Shippeddone
"Status" or section: In Review / QAin_review
"Status" or section: In Progress / Doingin_progress
Everything else (incomplete, no status)todo
Section: Cancelled / Archivedcanceled
Your data, handled with care.

We never read or store your source code, only task and PR metadata, statuses, and acceptance-criteria text. Least-privilege, revocable access: read plus the single write your workflow needs. Encrypted in transit and at rest, tenant-isolated. Every automated change is signed into an audit chain you can inspect, prove, and undo.

Want full state write-back?

On Jira, Linear, or Azure DevOps, GroundTruth sets real workflow states. Asana gives you accurate reads and honest completion write-back today.

Start free trial