Reference

Find implementation examples in Asana

Locate workers, schemas, mappings and configuration in the public Asana connector and template.

Use the public AirSync template for runnable SDK scaffolding. Use the public Asana connector to study a larger integration's API, domain model, normalization and tests.

Version compatibility

As checked on 16 October 2026, the public template and Asana use @devrev/airsync-sdk@2.0.0. Asana's SDK migration is merged into main; the code map below uses revision ee2a31f4e4ef746c7650f9c78e2f67ac430eec19.

Use the template for a minimal project and Asana for API integration, normalization, reverse sync and tests. Check code/package.json at the revision you use, install its dependencies and run its checks before adapting it to another system. Provider-specific behavior still needs your own implementation and validation.

Asana code map

Paths below are relative to the Asana repository and link to the checked revision.

TopicPublic source
External API client and generated API typescode/src/asana/api-client/
External types and metadatacode/src/asana/types.ts, external_domain_metadata.json
Normalization and testscode/src/asana/data-normalization.ts and adjacent .test.ts
Default mappingscode/src/asana/initial_domain_mapping.json
Sync-unit, metadata, data and attachment extractioncode/src/functions/extraction/workers/
Reverse-sync denormalizationcode/src/asana/data-denormalization.ts and adjacent .test.ts
Loading and attachment loadingcode/src/functions/loading/workers/
Rich text, permissions and loading helperscode/src/utils/
Connection and function declarationsmanifest.yaml

Read workers together with their helpers, metadata and tests. A source file's existence does not prove every edge case is supported. Validate the capabilities you implement against your own API and installation.

Template examples

The template includes extraction and loading worker families, normalized Todo/user records, metadata/default mapping, attachment handling and fixtures. Its external client uses in-memory demonstration data. Replace it with your own API calls, credential verification, pagination and durable continuation.

Run project setup, inspect the runtime contract, and use validation to check the resulting integration. Neither example replaces the supported-object and mapping references.

Last updated on