This repository contains the OpenAPI Specification for Asana's APIs.

To learn more about Asana's APIs, visit our developer documentation. You may also directly view API references for:

• Asana's REST API
• App components

1. Clone this repository to your local machine.

2. Navigate to project's root directory via your terminal, then install dependencies:

make setup

To build (i.e., update) the OpenAPI specifications for the REST API (./defs/asana_oas.yaml) and for app components (./defs/app_components_oas.yaml), create a new branch and run the following:

./bin/build_spec.sh

Note for internal Asanas: If you see errors regarding OPENAPI_DIR not being set, see this task: https://app.asana.com/0/0/1200652548580470/f

The script may take a few moments to fully run. When complete, create a pull request in this repository with the result.