Asana Projects API

The Asana Projects API is a tool that allows users to programmatically interact with Asana projects, enabling them to create, update, and manage tasks and projects within the Asana platform. By leveraging the API, developers can automate workflow processes, integrate Asana with other tools and applications, and access project data in real-time.

Operations 19

GET /projects Asana Get multiple projects #
POST /projects Asana Create a project #
GET /projects/{project_gid} Asana Get a project #
PUT /projects/{project_gid} Asana Update a project #
DELETE /projects/{project_gid} Asana Delete a project #
POST /projects/{project_gid}/duplicate Asana Duplicate a project #
GET /tasks/{task_gid}/projects Asana Get projects a task is in #
GET /teams/{team_gid}/projects Asana Get a team's projects #
POST /teams/{team_gid}/projects Asana Create a project in a team #
GET /workspaces/{workspace_gid}/projects Asana Get all projects in a workspace #
POST /workspaces/{workspace_gid}/projects Asana Create a project in a workspace #
POST /projects/{project_gid}/addCustomFieldSetting Asana Add a custom field to a project #
POST /projects/{project_gid}/removeCustomFieldSetting Asana Remove a custom field from a project #
GET /projects/{project_gid}/task_counts Asana Get task count of a project #
POST /projects/{project_gid}/addMembers Asana Add users to a project #
POST /projects/{project_gid}/removeMembers Asana Remove users from a project #
POST /projects/{project_gid}/addFollowers Asana Add followers to a project #
POST /projects/{project_gid}/removeFollowers Asana Remove followers from a project #
POST /projects/{project_gid}/saveAsTemplate Asana Create a project template from a project #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/asana-projects-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

asana-projects-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Asana Allocations Projects API
  description: The Asana Allocations API allows users to manage and allocate resources within their Asana project management system. An allocation object represents how much of a resource (e.g. person, team) is dedicated to a specific work object (e.g. project, portfolio) over a specific period of time. The effort value can be a percentage or number of hours.
  version: '1.0'
  termsOfService: https://asana.com/terms
  contact:
    name: Asana Support
    url: https://asana.com/support
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://app.asana.com/api/1.0
  description: Main endpoint.
security:
- personalAccessToken: []
- oauth2: []
tags:
- name: Projects
  description: 'A project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. A project exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.


    Projects in organizations are shared with a single team. Currently, the team of a project cannot be changed via the API. Non-organization workspaces do not have teams and so you should not specify the team of project in a regular workspace.


    Followers of a project are a subset of the members of that project. Followers of a project will receive all updates including tasks created, added and removed from that project. Members of the project have access to and will receive status updates of the project. Adding followers to a project will add them as members if they are not already, removing followers from a project will not affect membership.


    **Note:** You can use certain project endpoints to operate on [user task lists](/reference/user-task-lists) ([My Tasks](https://asana.com/guide/help/fundamentals/my-tasks)) by substituting the `{project_gid}` with the `{user_task_list_gid}`. For example, you can perform operations on the custom fields of a user task list by using the following projects endpoints: [Add a custom field to a project](/reference/addcustomfieldsettingforproject), [Remove a custom field from a project](/reference/removecustomfieldsettingforproject) and [Get a project''s custom fields](/reference/getcustomfieldsettingsforproject)'
paths:
  /projects:
    parameters:
    - $ref: '#/components/parameters/pretty'
    get:
      summary: Asana Get multiple projects
      description: 'Returns the compact project records for some filtered set of projects. Use one or more of the parameters provided to filter the projects returned.

        *Note: This endpoint may timeout for large domains. Try filtering by team!*'
      tags:
      - Projects
      operationId: getProjects
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/offset'
      - name: workspace
        in: query
        description: The workspace or organization to filter projects on.
        schema:
          type: string
        example: '1331'
      - name: team
        in: query
        description: The team to filter projects on.
        schema:
          type: string
        example: '14916'
      - $ref: '#/components/parameters/archived_query_param'
      - name: opt_fields
        in: query
        description: This endpoint returns a compact 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.
        required: false
        example:
        - archived
        - color
        - completed
        - completed_at
        - completed_by
        - completed_by.name
        - created_at
        - created_from_template
        - created_from_template.name
        - current_status
        - current_status.author
        - current_status.author.name
        - current_status.color
        - current_status.created_at
        - current_status.created_by
        - current_status.created_by.name
        - current_status.html_text
        - current_status.modified_at
        - current_status.text
        - current_status.title
        - current_status_update
        - current_status_update.resource_subtype
        - current_status_update.title
        - custom_field_settings
        - custom_field_settings.custom_field
        - custom_field_settings.custom_field.asana_created_field
        - custom_field_settings.custom_field.created_by
        - custom_field_settings.custom_field.created_by.name
        - custom_field_settings.custom_field.currency_code
        - custom_field_settings.custom_field.custom_label
        - custom_field_settings.custom_field.custom_label_position
        - custom_field_settings.custom_field.date_value
        - custom_field_settings.custom_field.date_value.date
        - custom_field_settings.custom_field.date_value.date_time
        - custom_field_settings.custom_field.description
        - custom_field_settings.custom_field.display_value
        - custom_field_settings.custom_field.enabled
        - custom_field_settings.custom_field.enum_options
        - custom_field_settings.custom_field.enum_options.color
        - custom_field_settings.custom_field.enum_options.enabled
        - custom_field_settings.custom_field.enum_options.name
        - custom_field_settings.custom_field.enum_value
        - custom_field_settings.custom_field.enum_value.color
        - custom_field_settings.custom_field.enum_value.enabled
        - custom_field_settings.custom_field.enum_value.name
        - custom_field_settings.custom_field.format
        - custom_field_settings.custom_field.has_notifications_enabled
        - custom_field_settings.custom_field.id_prefix
        - custom_field_settings.custom_field.is_formula_field
        - custom_field_settings.custom_field.is_global_to_workspace
        - custom_field_settings.custom_field.is_value_read_only
        - custom_field_settings.custom_field.multi_enum_values
        - custom_field_settings.custom_field.multi_enum_values.color
        - custom_field_settings.custom_field.multi_enum_values.enabled
        - custom_field_settings.custom_field.multi_enum_values.name
        - custom_field_settings.custom_field.name
        - custom_field_settings.custom_field.number_value
        - custom_field_settings.custom_field.people_value
        - custom_field_settings.custom_field.people_value.name
        - custom_field_settings.custom_field.precision
        - custom_field_settings.custom_field.representation_type
        - custom_field_settings.custom_field.resource_subtype
        - custom_field_settings.custom_field.text_value
        - custom_field_settings.custom_field.type
        - custom_field_settings.is_important
        - custom_field_settings.parent
        - custom_field_settings.parent.name
        - custom_field_settings.project
        - custom_field_settings.project.name
        - custom_fields
        - custom_fields.date_value
        - custom_fields.date_value.date
        - custom_fields.date_value.date_time
        - custom_fields.display_value
        - custom_fields.enabled
        - custom_fields.enum_options
        - custom_fields.enum_options.color
        - custom_fields.enum_options.enabled
        - custom_fields.enum_options.name
        - custom_fields.enum_value
        - custom_fields.enum_value.color
        - custom_fields.enum_value.enabled
        - custom_fields.enum_value.name
        - custom_fields.id_prefix
        - custom_fields.is_formula_field
        - custom_fields.multi_enum_values
        - custom_fields.multi_enum_values.color
        - custom_fields.multi_enum_values.enabled
        - custom_fields.multi_enum_values.name
        - custom_fields.name
        - custom_fields.number_value
        - custom_fields.representation_type
        - custom_fields.resource_subtype
        - custom_fields.text_value
        - custom_fields.type
        - default_access_level
        - default_view
        - due_date
        - due_on
        - followers
        - followers.name
        - html_notes
        - icon
        - members
        - members.name
        - minimum_access_level_for_customization
        - minimum_access_level_for_sharing
        - modified_at
        - name
        - notes
        - offset
        - owner
        - path
        - permalink_url
        - privacy_setting
        - project_brief
        - public
        - start_on
        - team
        - team.name
        - uri
        - workspace
        - workspace.name
        schema:
          type: array
          items:
            type: string
            enum:
            - archived
            - color
            - completed
            - completed_at
            - completed_by
            - completed_by.name
            - created_at
            - created_from_template
            - created_from_template.name
            - current_status
            - current_status.author
            - current_status.author.name
            - current_status.color
            - current_status.created_at
            - current_status.created_by
            - current_status.created_by.name
            - current_status.html_text
            - current_status.modified_at
            - current_status.text
            - current_status.title
            - current_status_update
            - current_status_update.resource_subtype
            - current_status_update.title
            - custom_field_settings
            - custom_field_settings.custom_field
            - custom_field_settings.custom_field.asana_created_field
            - custom_field_settings.custom_field.created_by
            - custom_field_settings.custom_field.created_by.name
            - custom_field_settings.custom_field.currency_code
            - custom_field_settings.custom_field.custom_label
            - custom_field_settings.custom_field.custom_label_position
            - custom_field_settings.custom_field.date_value
            - custom_field_settings.custom_field.date_value.date
            - custom_field_settings.custom_field.date_value.date_time
            - custom_field_settings.custom_field.description
            - custom_field_settings.custom_field.display_value
            - custom_field_settings.custom_field.enabled
            - custom_field_settings.custom_field.enum_options
            - custom_field_settings.custom_field.enum_options.color
            - custom_field_settings.custom_field.enum_options.enabled
            - custom_field_settings.custom_field.enum_options.name
            - custom_field_settings.custom_field.enum_value
            - custom_field_settings.custom_field.enum_value.color
            - custom_field_settings.custom_field.enum_value.enabled
            - custom_field_settings.custom_field.enum_value.name
            - custom_field_settings.custom_field.format
            - custom_field_settings.custom_field.has_notifications_enabled
            - custom_field_settings.custom_field.id_prefix
            - custom_field_settings.custom_field.is_formula_field
            - custom_field_settings.custom_field.is_global_to_workspace
            - custom_field_settings.custom_field.is_value_read_only
            - custom_field_settings.custom_field.multi_enum_values
            - custom_field_settings.custom_field.multi_enum_values.color
            - custom_field_settings.custom_field.multi_enum_values.enabled
            - custom_field_settings.custom_field.multi_enum_values.name
            - custom_field_settings.custom_field.name
            - custom_field_settings.custom_field.number_value
            - custom_field_settings.custom_field.people_value
            - custom_field_settings.custom_field.people_value.name
            - custom_field_settings.custom_field.precision
            - custom_field_settings.custom_field.representation_type
            - custom_field_settings.custom_field.resource_subtype
            - custom_field_settings.custom_field.text_value
            - custom_field_settings.custom_field.type
            - custom_field_settings.is_important
            - custom_field_settings.parent
            - custom_field_settings.parent.name
            - custom_field_settings.project
            - custom_field_settings.project.name
            - custom_fields
            - custom_fields.date_value
            - custom_fields.date_value.date
            - custom_fields.date_value.date_time
            - custom_fields.display_value
            - custom_fields.enabled
            - custom_fields.enum_options
            - custom_fields.enum_options.color
            - custom_fields.enum_options.enabled
            - custom_fields.enum_options.name
            - custom_fields.enum_value
            - custom_fields.enum_value.color
            - custom_fields.enum_value.enabled
            - custom_fields.enum_value.name
            - custom_fields.id_prefix
            - custom_fields.is_formula_field
            - custom_fields.multi_enum_values
            - custom_fields.multi_enum_values.color
            - custom_fields.multi_enum_values.enabled
            - custom_fields.multi_enum_values.name
            - custom_fields.name
            - custom_fields.number_value
            - custom_fields.representation_type
            - custom_fields.resource_subtype
            - custom_fields.text_value
            - custom_fields.type
            - default_access_level
            - default_view
            - due_date
            - due_on
            - followers
            - followers.name
            - html_notes
            - icon
            - members
            - members.name
            - minimum_access_level_for_customization
            - minimum_access_level_for_sharing
            - modified_at
            - name
            - notes
            - offset
            - owner
            - path
            - permalink_url
            - privacy_setting
            - project_brief
            - public
            - start_on
            - team
            - team.name
            - uri
            - workspace
            - workspace.name
        style: form
        explode: false
      responses:
        200:
          description: Successfully retrieved projects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ProjectCompact'
                  next_page:
                    $ref: '#/components/schemas/NextPage'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/Unauthorized'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotFound'
        500:
          $ref: '#/components/responses/InternalServerError'
      security:
      - oauth2:
        - projects:read
      x-readme:
        code-samples:
        - language: java
          install: <dependency><groupId>com.asana</groupId><artifactId>asana</artifactId><version>1.0.0</version></dependency>
          code: "import com.asana.Client;\n\nClient client = Client.accessToken(\"PERSONAL_ACCESS_TOKEN\");\n\nList<Project> result = client.projects.getProjects(archived, team, workspace)\n    .option(\"pretty\", true)\n    .execute();"
        - language: node
          install: npm install asana
          code: "const Asana = require('asana');\n\nlet client = Asana.ApiClient.instance;\nlet token = client.authentications['token'];\ntoken.accessToken = '<YOUR_ACCESS_TOKEN>';\n\nlet projectsApiInstance = new Asana.ProjectsApi();\nlet opts = { \n    'limit': 50, \n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", \n    'workspace': \"1331\", \n    'team': \"14916\", \n    'archived': false, \n    'opt_fields': \"archived,color,completed,completed_at,completed_by,completed_by.name,created_at,created_from_template,created_from_template.name,current_status,current_status.author,current_status.author.name,current_status.color,current_status.created_at,current_status.created_by,current_status.created_by.name,current_status.html_text,current_status.modified_at,current_status.text,current_status.title,current_status_update,current_status_update.resource_subtype,current_status_update.title,custom_field_settings,custom_field_settings.custom_field,custom_field_settings.custom_field.asana_created_field,custom_field_settings.custom_field.created_by,custom_field_settings.custom_field.created_by.name,custom_field_settings.custom_field.currency_code,custom_field_settings.custom_field.custom_label,custom_field_settings.custom_field.custom_label_position,custom_field_settings.custom_field.date_value,custom_field_settings.custom_field.date_value.date,custom_field_settings.custom_field.date_value.date_time,custom_field_settings.custom_field.description,custom_field_settings.custom_field.display_value,custom_field_settings.custom_field.enabled,custom_field_settings.custom_field.enum_options,custom_field_settings.custom_field.enum_options.color,custom_field_settings.custom_field.enum_options.enabled,custom_field_settings.custom_field.enum_options.name,custom_field_settings.custom_field.enum_value,custom_field_settings.custom_field.enum_value.color,custom_field_settings.custom_field.enum_value.enabled,custom_field_settings.custom_field.enum_value.name,custom_field_settings.custom_field.format,custom_field_settings.custom_field.has_notifications_enabled,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_value_read_only,custom_field_settings.custom_field.multi_enum_values,custom_field_settings.custom_field.multi_enum_values.color,custom_field_settings.custom_field.multi_enum_values.enabled,custom_field_settings.custom_field.multi_enum_values.name,custom_field_settings.custom_field.name,custom_field_settings.custom_field.number_value,custom_field_settings.custom_field.people_value,custom_field_settings.custom_field.people_value.name,custom_field_settings.custom_field.precision,custom_field_settings.custom_field.representation_type,custom_field_settings.custom_field.resource_subtype,custom_field_settings.custom_field.text_value,custom_field_settings.custom_field.type,custom_field_settings.is_important,custom_field_settings.parent,custom_field_settings.parent.name,custom_field_settings.project,custom_field_settings.project.name,custom_fields,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.display_value,custom_fields.enabled,custom_fields.enum_options,custom_fields.enum_options.color,custom_fields.enum_options.enabled,custom_fields.enum_options.name,custom_fields.enum_value,custom_fields.enum_value.color,custom_fields.enum_value.enabled,custom_fields.enum_value.name,custom_fields.id_prefix,custom_fields.is_formula_field,custom_fields.multi_enum_values,custom_fields.multi_enum_values.color,custom_fields.multi_enum_values.enabled,custom_fields.multi_enum_values.name,custom_fields.name,custom_fields.number_value,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,default_access_level,default_view,due_date,due_on,followers,followers.name,html_notes,icon,members,members.name,minimum_access_level_for_customization,minimum_access_level_for_sharing,modified_at,name,notes,offset,owner,path,permalink_url,privacy_setting,project_brief,public,start_on,team,team.name,uri,workspace,workspace.name\"\n};\nprojectsApiInstance.getProjects(opts).then((result) => {\n    console.log('API called successfully. Returned data: ' + JSON.stringify(result.data, null, 2));\n}, (error) => {\n    console.error(error.response.body);\n});"
          name: node-sdk-v3
        - language: node
          install: npm install asana@1.0.5
          code: "const asana = require('asana');\n\nconst client = asana.Client.create().useAccessToken('PERSONAL_ACCESS_TOKEN');\n\nclient.projects.getProjects({param: \"value\", param: \"value\", opt_pretty: true})\n    .then((result) => {\n        console.log(result);\n    });"
          name: node-sdk-v1
        - language: python
          install: pip install asana
          code: "import asana\nfrom asana.rest import ApiException\nfrom pprint import pprint\n\nconfiguration = asana.Configuration()\nconfiguration.access_token = '<YOUR_ACCESS_TOKEN>'\napi_client = asana.ApiClient(configuration)\n\n# create an instance of the API class\nprojects_api_instance = asana.ProjectsApi(api_client)\nopts = {\n    'limit': 50, # int | Results per page. The number of objects to return per page. The value must be between 1 and 100.\n    'offset': \"eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9\", # str | Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. *Note: You can only pass in an offset that was returned to you via a previously paginated request.*\n    'workspace': \"1331\", # str | The workspace or organization to filter projects on.\n    'team': \"14916\", # str | The team to filter projects on.\n    'archived': False, # bool | Only return projects whose `archived` field takes on the value of this parameter.\n    'opt_fields': \"archived,color,completed,completed_at,completed_by,completed_by.name,created_at,created_from_template,created_from_template.name,current_status,current_status.author,current_status.author.name,current_status.color,current_status.created_at,current_status.created_by,current_status.created_by.name,current_status.html_text,current_status.modified_at,current_status.text,current_status.title,current_status_update,current_status_update.resource_subtype,current_status_update.title,custom_field_settings,custom_field_settings.custom_field,custom_field_settings.custom_field.asana_created_field,custom_field_settings.custom_field.created_by,custom_field_settings.custom_field.created_by.name,custom_field_settings.custom_field.currency_code,custom_field_settings.custom_field.custom_label,custom_field_settings.custom_field.custom_label_position,custom_field_settings.custom_field.date_value,custom_field_settings.custom_field.date_value.date,custom_field_settings.custom_field.date_value.date_time,custom_field_settings.custom_field.description,custom_field_settings.custom_field.display_value,custom_field_settings.custom_field.enabled,custom_field_settings.custom_field.enum_options,custom_field_settings.custom_field.enum_options.color,custom_field_settings.custom_field.enum_options.enabled,custom_field_settings.custom_field.enum_options.name,custom_field_settings.custom_field.enum_value,custom_field_settings.custom_field.enum_value.color,custom_field_settings.custom_field.enum_value.enabled,custom_field_settings.custom_field.enum_value.name,custom_field_settings.custom_field.format,custom_field_settings.custom_field.has_notifications_enabled,custom_field_settings.custom_field.id_prefix,custom_field_settings.custom_field.is_formula_field,custom_field_settings.custom_field.is_global_to_workspace,custom_field_settings.custom_field.is_value_read_only,custom_field_settings.custom_field.multi_enum_values,custom_field_settings.custom_field.multi_enum_values.color,custom_field_settings.custom_field.multi_enum_values.enabled,custom_field_settings.custom_field.multi_enum_values.name,custom_field_settings.custom_field.name,custom_field_settings.custom_field.number_value,custom_field_settings.custom_field.people_value,custom_field_settings.custom_field.people_value.name,custom_field_settings.custom_field.precision,custom_field_settings.custom_field.representation_type,custom_field_settings.custom_field.resource_subtype,custom_field_settings.custom_field.text_value,custom_field_settings.custom_field.type,custom_field_settings.is_important,custom_field_settings.parent,custom_field_settings.parent.name,custom_field_settings.project,custom_field_settings.project.name,custom_fields,custom_fields.date_value,custom_fields.date_value.date,custom_fields.date_value.date_time,custom_fields.display_value,custom_fields.enabled,custom_fields.enum_options,custom_fields.enum_options.color,custom_fields.enum_options.enabled,custom_fields.enum_options.name,custom_fields.enum_value,custom_fields.enum_value.color,custom_fields.enum_value.enabled,custom_fields.enum_value.name,custom_fields.id_prefix,custom_fields.is_formula_field,custom_fields.multi_enum_values,custom_fields.multi_enum_values.color,custom_fields.multi_enum_values.enabled,custom_fields.multi_enum_values.name,custom_fields.name,custom_fields.number_value,custom_fields.representation_type,custom_fields.resource_subtype,custom_fields.text_value,custom_fields.type,default_access_level,default_view,due_date,due_on,followers,followers.name,html_notes,icon,members,members.name,minimum_access_level_for_customization,minimum_access_level_for_sharing,modified_at,name,notes,offset,owner,path,permalink_url,privacy_setting,project_brief,public,start_on,team,team.name,uri,workspace,workspace.name\", # list[str] | This endpoint returns a compact 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.\n}\n\ntry:\n    # Get multiple projects\n    api_response = projects_api_instance.get_projects(opts)\n    for data in api_response:\n        pprint(data)\nexcept ApiException as e:\n    print(\"Exception when calling ProjectsApi->get_projects: %s\\n\" % e)"
          name: python-sdk-v5
        - language: python
          install: pip install asana==3.2.3
          code: 'import asana


            client = asana.Client.access_token(''PERSONAL_ACCESS_TOKEN'')


            result = client.projects.get_projects({''param'': ''value'', ''param'': ''value''}, opt_pretty=True)'
          name: python-sdk-v3
        - language: php
          install: composer require asana/asana
          code: '<?php

            require ''vendor/autoload.php'';


            $client = Asana\Client::accessToken(''PERSONAL_ACCESS_TOKEN'');


            $result = $client->projects->getProjects(array(''param'' => ''value'', ''param'' => ''value''), array(''opt_pretty'' => ''true''))'
        - language: ruby
          install: gem install asana
          code: "require 'asana'\n\nclient = Asana::Client.new do |c|\n    c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'\nend\n\nresult = client.projects.get_projects(param: \"value\", param: \"value\", options: {pretty: true})"
    post:
      summary: Asana Create a project
      description: 'Create a new project in a workspace or team.


        Every project is required to be created in a specific workspace or

        organization, and this cannot be changed once set. Note that you can use

        the `workspace` parameter regardless of whether or not it is an

        organization.


        If the workspace for your project is an organization, you must also

        supply a `team` to share the project with.


        Returns the full record of the newly created project.'
      tags:
      - Projects
      operationId: createProject
      parameters:
      - name: opt_fields
        in: query
        description: This endpoint returns a compact 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.
        required: false
        example:
        - archived
        - color
        - completed
        - completed_at
        - completed_by
        - completed_by.name
        - created_at
        - created_from_template
        - created_from_template.name
        - current_status
        - current_status.author
        - current_status.author.name
        - current_status.color
        - current_status.created_at
        - current_status.created_by
        - current_status.created_by.name
        - current_status.html_text
        - current_status.modified_at
        - current_status.text
        - current_status.title
        - current_status_update
        - current_status_update.resource_subtype
        - current_status_update.title
        - custom_field_settings
        - custom_field_settings.custom_field
        - custom_field_settings.custom_field.asana_created_field
        - custom_field_settings.custom_field.created_by
        - custom_field_settings.custom_field.created_by.name
        - custom_field_settings.custom_field.currency_code
        - custom_field_settings.custom_field.custom_label
        - custom_field_settings.custom_field.custom_label_position
        - custom_field_settings.custom_field.date_value
        - custom_field_settings.custom_field.date_value.date
        - custom_field_settings.custom_field.date_value.date_time
        - custom_field_settings.custom_field.description
        - custom_field_settings.custom_field.display_value
        - custom_field_settings.custom_field.enabled
        - custom_field_settings.custom_field.enum_options
        - custom_field_settings.custom_field.enum_options.color
        - custom_field_settings.custom_field.enum_options.enabled
        - custom_field_settings.custom_field.enum_options.name
        - custom_field_settings.custom_field.enum_value
        - custom_field_settings.custom_field.enum_value.color
        - custom_field_settings.custom_field.enum_value.enabled
        - custom_field_settings.custom_field.enum_value.name
        - custom_field_settings.custom_field.format
        - custom_field_settings.custom_field.has_notifications_enabled
        - custom_field_settings.custom_field.id_prefix
        - custom_field_settings.custom_field.is_formula_field
        - custom_field_settings.custom_field.is_global_to_workspace
        - custom_field_settings.custom_field.is_value_read_only
        - custom_field_settings.custom_field.multi_enum_values
        - custom_field_settings.custom_field.multi_enum_values.color
        - custom_field_settings.custom_field.multi_enum_values.enabled
        - custom_field_settings.custom_field.multi_enum_values.name
        - custom_field_settings.custom_field.name
        - custom_field_settings.custom_field.number_value
        - custom_field_settings.custom_field.people_value
        - custom_field_settings.custom_field.people_value.name
        - custom_field_settings.custom_field.precision
        - custom_field_settings.custom_field.representation_type
        - custom_field_settings.custom_field.resource_subtype
        - custom_field_settings.custom_field.text_value
        - custom_field_settings.custom_field.type
        - custom_field_settings.is_important
        - custom_field_settings.parent
        - custom_field_settings.parent.name
        - custom_field_settings.project
        - custom_field_settings.project.name
        - custom_fields
        - custom_fields.date_value
        - custom_fields.date_value.date
        - custom_fields.date_value.date_time
        - custom_fields.display_value
        - custom_fields.enabled
        - custom_fields.enum_options
        - custom_fields.enum_options.color
        - custom_fields.enum_options.enabled
        - custom_fields.enum_options.name
        - custom_fields.enum_value
        - custom_fields.enum_value.color
        - custom_fields.enum_value.enabled
        - custom_fields.enum_value.name
        - custom_fields.id_prefix
        - custom_fields.is_formula_field
        - custom_fields.multi_enum_values
        - custom_fields.multi_enum_values.color
        - custom_fields.multi_enum_values.enabled
        - custom_fields.multi_enum_values.name
        - custom_fields.name
        - custom_fields.number_value
        - custom_fields.representation_type
        - custom_fields.resource_subtype
        - custom_fields.text_value
        - custom_fields.type
        - default_access_level
        - default_view
        - due_date
        - due_on
        - followers
        - followers.name
        - html_notes
        - icon
        - members
        - members.name
        - minimum_access_level_for_customization
        - minimum_access_level_for_sharing
        - modified_at
        - name
        - notes
        - owner
        - permalink_url
        - privacy_setting
        - project_brief
        - public
        - start_on
        - team
        - t

# --- truncated at 32 KB (402 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-projects-api-openapi.yml