Automated build docs: 2026-02-03 01:16:45

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

defs/asana_oas.yaml

@@ -679,7 +679,7 @@ tags:
   - name: Memberships
     description: |-
       A membership object represents the relationship between a team or user and an object in Asana. Currently, the
-      supported types of memberships are for goals, projects, and portfolios. For example, a project membership
+      supported types of memberships are for goals, projects, custom fields, custom types,and portfolios. For example, a project membership
       can be used to add a user to a project.
   - name: Organization exports
     description: >-
@@ -4185,6 +4185,7 @@ components:
         - $ref: '#/components/schemas/ProjectMembershipCompactResponse'
         - $ref: '#/components/schemas/PortfolioMembershipCompactResponse'
         - $ref: '#/components/schemas/CustomFieldMembershipCompact'
+        - $ref: '#/components/schemas/CustomTypeMembershipCompact'
     ModifyDependenciesRequest:
       type: object
       properties:
@@ -5143,6 +5144,52 @@ components:
           example: admin
     CustomFieldMembershipResponse:
       $ref: '#/components/schemas/CustomFieldMembershipBase'
+    CustomTypeMembershipBase:
+      $ref: '#/components/schemas/CustomTypeMembershipCompact'
+    CustomTypeMembershipCompact:
+      description: >-
+        This object describes a user or team's membership to a custom type including
+        their level of access (Admin, Editor, User, or Viewer).
+      type: object
+      properties:
+        gid:
+          description: >-
+            Globally unique identifier of the resource, as a string.
+          type: string
+          readOnly: true
+          example: '12345'
+          x-insert-after: false
+        resource_type:
+          description: The base type of this resource.
+          type: string
+          readOnly: true
+          example: custom_type_membership
+          x-insert-after: gid
+        resource_subtype:
+          description: Type of the membership.
+          type: string
+          example: custom_type_membership
+        parent:
+          description: >-
+            The custom type the user or team is a member of.
+          $ref: '#/components/schemas/CustomTypeCompact'
+        member:
+          description: Member can be a user or a team.
+          $ref: '#/components/schemas/MemberCompact'
+        access_level:
+          description: >-
+            Whether the member has admin, editor, user, or viewer
+            access to the custom type.
+          type: string
+          enum:
+            - admin
+            - editor
+            - user
+            - viewer
+          readOnly: true
+          example: admin
+    CustomTypeMembershipResponse:
+      $ref: '#/components/schemas/CustomTypeMembershipBase'
     ProjectMembershipBase:
       $ref: '#/components/schemas/ProjectMembershipCompact'
     ProjectMembershipCompact:
@@ -9086,6 +9133,7 @@ components:
         - $ref: '#/components/schemas/ProjectMembershipCompactResponse'
         - $ref: '#/components/schemas/PortfolioMembershipResponse'
         - $ref: '#/components/schemas/CustomFieldMembershipResponse'
+        - $ref: '#/components/schemas/CustomTypeMembershipResponse'
     UpdateTimeTrackingEntryRequest:
       type: object
       properties:
@@ -20764,9 +20812,10 @@ paths:
       summary: Get multiple memberships
       description: >-
         Returns compact `goal_membership`, `project_membership`, `portfolio_membership`,
-        or `custom_field_membership` records. The possible types
-        for `parent` in this request are `goal`, `project`, `portfolio`, or `custom_field`.
-        An additional member (user GID or
+        `custom_type_membership`, or `custom_field_membership` records. The possible
+        types
+        for `parent` in this request are `goal`, `project`, `portfolio`, `custom_type`,
+        or `custom_field`. An additional member (user GID or
         team GID) can be passed in to filter to a specific membership.
 
 
@@ -20782,7 +20831,8 @@ paths:
         - name: parent
           in: query
           description: >-
-            Globally unique identifier for `goal`, `project`, `portfolio`, or `custom_field`.
+            Globally unique identifier for `goal`, `project`, `portfolio`, `custom_type`,
+            or `custom_field`.
             This parameter is optional when `resource_subtype` is provided along with
             `member`.
           schema:
@@ -20968,7 +21018,7 @@ paths:
     post:
       summary: Create a membership
       description: |-
-        Creates a new membership in a `goal`, `project`, `portfolio`, or `custom_field`, where members can be Teams or Users.
+        Creates a new membership in a `goal`, `project`, `portfolio`, `custom_type`, or `custom_field`, where members can be Teams or Users.
 
         Returns the full record of the newly created membership.
       tags:
@@ -21114,7 +21164,8 @@ paths:
       summary: Get a membership
       description: >-
         Returns a `project_membership`, `goal_membership`, `portfolio_membership`,
-        or `custom_field_membership` record for a membership id.
+        `custom_type_membership`, or `custom_field_membership` record for a membership
+        id.
       tags:
         - Memberships
       operationId: getMembership
@@ -21216,7 +21267,7 @@ paths:
       summary: Update a membership
       description: |-
         An existing membership can be updated by making a `PUT` request on the membership. Only the fields provided in the `data` block will be updated;
-        any unspecified fields will remain unchanged. Memberships on `goals`, `projects`, `portfolios`, and `custom_fields` can be updated.
+        any unspecified fields will remain unchanged. Memberships on `goals`, `projects`, `portfolios`, `custom_types`, and `custom_fields` can be updated.
 
         Returns the full record of the updated membership.
       tags:
@@ -21356,7 +21407,7 @@ paths:
     delete:
       summary: Delete a membership
       description: |-
-        A specific, existing membership for a `goal`, `project`, `portfolio` or `custom_field` can be deleted by making a `DELETE` request
+        A specific, existing membership for a `goal`, `project`, `portfolio`, `custom_type`, or `custom_field` can be deleted by making a `DELETE` request
         on the URL for that membership.
 
         Returns an empty data record.