Automated build docs: 2026-01-21 08:31:52

Author: asana-push-openapi-spec[bot]

defs/asana_oas.yaml

@@ -28685,6 +28685,7 @@ paths:
 
         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!*
+        **The `team` filter is deprecated.** Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` to find projects shared with a team.
       tags:
         - Projects
       operationId: getProjects
@@ -28700,10 +28701,14 @@ paths:
           example: '1331'
         - name: team
           in: query
-          description: The team to filter projects on.
+          description: >-
+            **Deprecated.** The team to filter projects on. Please use `GET /memberships`
+            with
+            `{ member: team, resource_subtype: project_membership }` instead.
           schema:
             type: string
           example: '14916'
+          deprecated: true
         - $ref: '#/components/parameters/archived_query_param'
         - name: opt_fields
           in: query

defs/asana_postman_collection.json

@@ -39673,7 +39673,7 @@
                   "type": "string",
                   "disabled": true,
                   "description": {
-                    "content": "The team to filter projects on.",
+                    "content": "**Deprecated.** The team to filter projects on. Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` instead.",
                     "type": "text/markdown"
                   }
                 },
@@ -39701,7 +39701,7 @@
             },
             "body": null,
             "description": {
-              "content": "<b>Required scope: </b><code>projects:read</code>\n\nReturns the compact project records for some filtered set of projects. Use one or more of the parameters provided to filter the projects returned.\n*Note: This endpoint may timeout for large domains. Try filtering by team!*\n\n## Response Body:\n\n| Field | Type | Enum Values | Description |\n|-------|------|-------------|-------------|\n| `data` | array[object] |  |  |\n| `data[].gid` | string |  | Globally unique identifier of the resource, as a string. |\n| `data[].resource_type` | string |  | The base type of this resource. |\n| `data[].name` | string |  | Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer. |\n| `next_page` | object |  | *Conditional*. This property is only present when a limit query parameter is provided in the request. When making a paginated request, the API will return a number of results as specified by the limit parameter. If more results exist, then the response will contain a next_page attribute, which will include an offset, a relative path attribute, and a full uri attribute. If there are no more pages available, next_page will be null and no offset will be provided. Note that an offset token will expire after some time, as data may have changed. |\n| `next_page.offset` | string |  | Pagination offset for the request. |\n| `next_page.path` | string |  | A relative path containing the query parameters to fetch for next_page |\n| `next_page.uri` | string(uri) |  | A full uri containing the query parameters to fetch for next_page |",
+              "content": "<b>Required scope: </b><code>projects:read</code>\n\nReturns the compact project records for some filtered set of projects. Use one or more of the parameters provided to filter the projects returned.\n*Note: This endpoint may timeout for large domains. Try filtering by team!*\n**The `team` filter is deprecated.** Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` to find projects shared with a team.\n\n## Response Body:\n\n| Field | Type | Enum Values | Description |\n|-------|------|-------------|-------------|\n| `data` | array[object] |  |  |\n| `data[].gid` | string |  | Globally unique identifier of the resource, as a string. |\n| `data[].resource_type` | string |  | The base type of this resource. |\n| `data[].name` | string |  | Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer. |\n| `next_page` | object |  | *Conditional*. This property is only present when a limit query parameter is provided in the request. When making a paginated request, the API will return a number of results as specified by the limit parameter. If more results exist, then the response will contain a next_page attribute, which will include an offset, a relative path attribute, and a full uri attribute. If there are no more pages available, next_page will be null and no offset will be provided. Note that an offset token will expire after some time, as data may have changed. |\n| `next_page.offset` | string |  | Pagination offset for the request. |\n| `next_page.path` | string |  | A relative path containing the query parameters to fetch for next_page |\n| `next_page.uri` | string(uri) |  | A full uri containing the query parameters to fetch for next_page |",
               "type": "text/markdown"
             }
           },
@@ -39765,7 +39765,7 @@
                       "type": "string",
                       "disabled": true,
                       "description": {
-                        "content": "The team to filter projects on.",
+                        "content": "**Deprecated.** The team to filter projects on. Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` instead.",
                         "type": "text/markdown"
                       }
                     },
@@ -39873,7 +39873,7 @@
                       "type": "string",
                       "disabled": true,
                       "description": {
-                        "content": "The team to filter projects on.",
+                        "content": "**Deprecated.** The team to filter projects on. Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` instead.",
                         "type": "text/markdown"
                       }
                     },
@@ -39981,7 +39981,7 @@
                       "type": "string",
                       "disabled": true,
                       "description": {
-                        "content": "The team to filter projects on.",
+                        "content": "**Deprecated.** The team to filter projects on. Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` instead.",
                         "type": "text/markdown"
                       }
                     },
@@ -40089,7 +40089,7 @@
                       "type": "string",
                       "disabled": true,
                       "description": {
-                        "content": "The team to filter projects on.",
+                        "content": "**Deprecated.** The team to filter projects on. Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` instead.",
                         "type": "text/markdown"
                       }
                     },
@@ -40197,7 +40197,7 @@
                       "type": "string",
                       "disabled": true,
                       "description": {
-                        "content": "The team to filter projects on.",
+                        "content": "**Deprecated.** The team to filter projects on. Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` instead.",
                         "type": "text/markdown"
                       }
                     },
@@ -40305,7 +40305,7 @@
                       "type": "string",
                       "disabled": true,
                       "description": {
-                        "content": "The team to filter projects on.",
+                        "content": "**Deprecated.** The team to filter projects on. Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` instead.",
                         "type": "text/markdown"
                       }
                     },

defs/asana_sdk_oas.yaml

@@ -51746,6 +51746,7 @@ paths:
 
         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!*
+        **The `team` filter is deprecated.** Please use `GET /memberships` with `{ member: team, resource_subtype: project_membership }` to find projects shared with a team.
       tags:
         - Projects
       operationId: getProjects
@@ -51761,10 +51762,14 @@ paths:
           example: '1331'
         - name: team
           in: query
-          description: The team to filter projects on.
+          description: >-
+            **Deprecated.** The team to filter projects on. Please use `GET /memberships`
+            with
+            `{ member: team, resource_subtype: project_membership }` instead.
           schema:
             type: string
           example: '14916'
+          deprecated: true
         - $ref: '#/components/parameters/archived_query_param'
         - name: opt_fields
           in: query